4 * Copyright 1998,2000 Andreas Mohr
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
11 * This library is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 * Lesser General Public License for more details.
16 * You should have received a copy of the GNU Lesser General Public
17 * License along with this library; if not, write to the Free Software
18 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20 * FIXME: Rather non-functional functions for now.
23 * http://www.geocities.com/SiliconValley/Network/5317/drivers.html
24 * http://willemer.de/informatik/windows/inf_info.htm (German)
25 * http://www.microsoft.com/ddk/ddkdocs/win98ddk/devinst_12uw.htm
27 * http://mmatrix.tripod.com/customsystemfolder/infsysntaxfull.html
28 * http://www.rdrop.com/~cary/html/inf_faq.html
29 * http://support.microsoft.com/support/kb/articles/q194/6/40.asp
32 * - rs405deu.exe (German Acroread 4.05 setup)
37 * - string handling is... weird ;) (buflen etc.)
39 * - separate that mess (but probably only when it's done completely)
41 * SETUPX consists of several parts with the following acronyms/prefixes:
42 * Di device installer (devinst.c ?)
43 * Gen generic installer (geninst.c ?)
44 * Ip .INF parsing (infparse.c)
45 * LDD logical device descriptor (ldd.c ?)
46 * LDID logical device ID
47 * SU setup (setup.c ?)
48 * Tp text processing (textproc.c ?)
49 * Vcp virtual copy module (vcp.c ?)
52 * The SETUPX DLL is NOT thread-safe. That's why many installers urge you to
53 * "close all open applications".
54 * All in all the design of it seems to be a bit weak.
55 * Not sure whether my implementation of it is better, though ;-)
63 #include "wine/winuser16.h"
66 #include "setupapi_private.h"
68 #include "wine/debug.h"
70 WINE_DEFAULT_DEBUG_CHANNEL(setupapi
);
72 #define HWND_32(h16) ((HWND)(ULONG_PTR)(h16))
74 /***********************************************************************
75 * SURegOpenKey (SETUPX.47)
77 DWORD WINAPI
SURegOpenKey( HKEY hkey
, LPCSTR lpszSubKey
, LPHKEY retkey
)
79 FIXME("(%x,%s,%p), semi-stub.\n",hkey
,debugstr_a(lpszSubKey
),retkey
);
80 return RegOpenKeyA( hkey
, lpszSubKey
, retkey
);
83 /***********************************************************************
84 * SURegQueryValueEx (SETUPX.50)
86 DWORD WINAPI
SURegQueryValueEx( HKEY hkey
, LPSTR lpszValueName
,
87 LPDWORD lpdwReserved
, LPDWORD lpdwType
,
88 LPBYTE lpbData
, LPDWORD lpcbData
)
90 FIXME("(%x,%s,%p,%p,%p,%ld), semi-stub.\n",hkey
,debugstr_a(lpszValueName
),
91 lpdwReserved
,lpdwType
,lpbData
,lpcbData
?*lpcbData
:0);
92 return RegQueryValueExA( hkey
, lpszValueName
, lpdwReserved
, lpdwType
,
97 * Returns pointer to a string list with the first entry being number
100 * Hmm. Should this be InitSubstrData(), GetFirstSubstr() and GetNextSubstr()
103 static LPSTR
*SETUPX_GetSubStrings(LPSTR start
, char delimiter
)
114 /* find beginning of real substring */
115 while ( (*p
== ' ') || (*p
== '\t') || (*p
== '"') ) p
++;
117 /* find end of real substring */
120 && (*q
!= ' ') && (*q
!= '\t') && (*q
!= '"')
121 && (*q
!= ';') && (*q
!= delimiter
) ) q
++;
124 len
= (int)q
- (int)p
;
126 /* alloc entry for new substring in steps of 32 units and copy over */
128 { /* 1 for count field + current count + 32 */
129 res
= HeapReAlloc(GetProcessHeap(), 0, res
, (1+count
+32)*sizeof(LPSTR
));
131 *(res
+1+count
) = HeapAlloc(GetProcessHeap(), 0, len
+1);
132 strncpy(*(res
+1+count
), p
, len
);
133 (*(res
+1+count
))[len
] = '\0';
136 /* we are still within last substring (before delimiter),
137 * so get out of it */
138 while ((*q
) && (*q
!= ';') && (*q
!= delimiter
)) q
++;
139 if ((!*q
) || (*q
== ';'))
144 /* put number of entries at beginning of list */
145 *(DWORD
*)res
= count
;
149 static void SETUPX_FreeSubStrings(LPSTR
*substr
)
151 DWORD count
= *(DWORD
*)substr
;
152 LPSTR
*pStrings
= substr
+1;
155 for (n
=0; n
< count
; n
++)
156 HeapFree(GetProcessHeap(), 0, *pStrings
++);
158 HeapFree(GetProcessHeap(), 0, substr
);
162 /***********************************************************************
163 * InstallHinfSection (SETUPX.527)
165 * hwnd = parent window
166 * hinst = instance of SETUPX.DLL
167 * lpszCmdLine = e.g. "DefaultInstall 132 C:\MYINSTALL\MYDEV.INF"
168 * Here "DefaultInstall" is the .inf file section to be installed (optional).
169 * The 132 value is made of the HOW_xxx flags and sometimes 128 (-> setupx16.h).
171 * nCmdShow = nCmdShow of CreateProcess
173 RETERR16 WINAPI
InstallHinfSection16( HWND16 hwnd
, HINSTANCE16 hinst
, LPCSTR lpszCmdLine
, INT16 nCmdShow
)
178 RETERR16 res
= OK
, tmp
;
182 TRACE("(%04x, %04x, %s, %d);\n", hwnd
, hinst
, lpszCmdLine
, nCmdShow
);
184 pSub
= SETUPX_GetSubStrings((LPSTR
)lpszCmdLine
, ' ');
186 count
= *(DWORD
*)pSub
;
187 if (count
< 2) /* invalid number of arguments ? */
189 if (IpOpen16(*(pSub
+count
), &hInf
) != OK
)
191 res
= ERROR_FILE_NOT_FOUND
; /* yes, correct */
194 if (VcpOpen16(NULL
, 0))
196 if (GenInstall16(hInf
, *(pSub
+count
-2), GENINSTALL_DO_ALL
) != OK
)
198 wFlags
= atoi(*(pSub
+count
-1)) & ~128;
201 case HOW_ALWAYS_SILENT_REBOOT
:
202 case HOW_SILENT_REBOOT
:
205 case HOW_ALWAYS_PROMPT_REBOOT
:
206 case HOW_PROMPT_REBOOT
:
207 if (MessageBoxA(HWND_32(hwnd
), "You must restart Wine before the new settings will take effect.\n\nDo you want to exit Wine now ?", "Systems Settings Change", MB_YESNO
|MB_ICONQUESTION
) == IDYES
)
211 ERR("invalid flags %d !\n", wFlags
);
217 tmp
= VcpClose16(VCPFL_ALL
, NULL
);
220 tmp
= IpClose16(hInf
);
223 SETUPX_FreeSubStrings(pSub
);
226 /* FIXME: we should have a means of terminating all wine + wineserver */
227 MESSAGE("Program or user told me to restart. Exiting Wine...\n");
237 LPCSTR StdString
; /* fallback string; sub dir of windows directory */
240 static const LDID_DATA LDID_Data
[34] =
242 { /* 0 (LDID_NULL) -- not defined */
246 { /* 1 (LDID_SRCPATH) = source of installation. hmm, what to do here ? */
247 "SourcePath", /* hmm, does SETUPX have to care about updating it ?? */
250 { /* 2 (LDID_SETUPTEMP) = setup temp dir */
254 { /* 3 (LDID_UNINSTALL) = uninstall backup dir */
258 { /* 4 (LDID_BACKUP) = backup dir */
262 { /* 5 (LDID_SETUPSCRATCH) = setup scratch dir */
266 { /* 6 -- not defined */
270 { /* 7 -- not defined */
274 { /* 8 -- not defined */
278 { /* 9 -- not defined */
282 { /* 10 (LDID_WIN) = windows dir */
286 { /* 11 (LDID_SYS) = system dir */
288 NULL
/* call GetSystemDirectory() instead */
290 { /* 12 (LDID_IOS) = IOSubSys dir */
291 NULL
, /* FIXME: registry string ? */
294 { /* 13 (LDID_CMD) = COMMAND dir */
295 NULL
, /* FIXME: registry string ? */
298 { /* 14 (LDID_CPL) = control panel dir */
302 { /* 15 (LDID_PRINT) = windows printer dir */
304 "SYSTEM" /* correct ?? */
306 { /* 16 (LDID_MAIL) = destination mail dir */
310 { /* 17 (LDID_INF) = INF dir */
311 "SetupScratchDir", /* correct ? */
314 { /* 18 (LDID_HELP) = HELP dir */
318 { /* 19 (LDID_WINADMIN) = Admin dir */
322 { /* 20 (LDID_FONTS) = Fonts dir */
326 { /* 21 (LDID_VIEWERS) = Viewers */
330 { /* 22 (LDID_VMM32) = VMM32 dir */
334 { /* 23 (LDID_COLOR) = ICM dir */
338 { /* 24 (LDID_APPS) = root of boot drive ? */
342 { /* 25 (LDID_SHARED) = shared dir */
346 { /* 26 (LDID_WINBOOT) = Windows boot dir */
350 { /* 27 (LDID_MACHINE) = machine specific files */
354 { /* 28 (LDID_HOST_WINBOOT) = Host Windows boot dir */
358 { /* 29 -- not defined */
362 { /* 30 (LDID_BOOT) = Root of boot drive */
366 { /* 31 (LDID_BOOT_HOST) = Root of boot drive host */
370 { /* 32 (LDID_OLD_WINBOOT) = subdir of root */
374 { /* 33 (LDID_OLD_WIN) = old win dir */
378 /* the rest (34-38) isn't too interesting, so I'll forget about it */
382 * LDD == Logical Device Descriptor
383 * LDID == Logical Device ID
385 * The whole LDD/LDID business might go into a separate file named
387 * At the moment I don't know what the hell these functions are really doing.
388 * That's why I added reporting stubs.
389 * The only thing I do know is that I need them for the LDD/LDID infrastructure.
390 * That's why I implemented them in a way that's suitable for my purpose.
392 static LDD_LIST
*pFirstLDD
= NULL
;
394 static BOOL std_LDDs_done
= FALSE
;
396 void SETUPX_CreateStandardLDDs(void)
402 char buffer
[MAX_PATH
];
404 /* has to be here, otherwise loop */
405 std_LDDs_done
= TRUE
;
407 RegOpenKeyA(HKEY_LOCAL_MACHINE
, "SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Setup", &hKey
);
409 for (n
=0; n
< sizeof(LDID_Data
)/sizeof(LDID_DATA
); n
++)
414 if ( (hKey
) && (LDID_Data
[n
].RegValName
)
415 && (RegQueryValueExA(hKey
, LDID_Data
[n
].RegValName
,
416 NULL
, &type
, buffer
, &len
) == ERROR_SUCCESS
)
417 && (type
== REG_SZ
) )
419 TRACE("found value '%s' for LDID %d\n", buffer
, n
);
425 FIXME("LDID_SRCPATH: what exactly do we have to do here ?\n");
426 strcpy(buffer
, "X:\\FIXME");
429 GetSystemDirectoryA(buffer
, MAX_PATH
);
433 case LDID_HOST_WINBOOT
:
436 strcpy(buffer
, "C:\\");
439 if (LDID_Data
[n
].StdString
)
441 DWORD len
= GetWindowsDirectoryA(buffer
, MAX_PATH
);
445 strcpy(p
, LDID_Data
[n
].StdString
);
452 ldd
.pszPath
= buffer
;
453 TRACE("LDID %d -> '%s'\n", ldd
.ldid
, ldd
.pszPath
);
457 if (hKey
) RegCloseKey(hKey
);
460 /***********************************************************************
461 * CtlDelLdd (SETUPX.37)
464 * ERR_VCP_LDDINVALID if ldid < LDID_ASSIGN_START.
466 RETERR16
SETUPX_DelLdd(LOGDISKID16 ldid
)
468 LDD_LIST
*pCurr
, *pPrev
= NULL
;
470 TRACE("(%d)\n", ldid
);
473 SETUPX_CreateStandardLDDs();
475 if (ldid
< LDID_ASSIGN_START
)
476 return ERR_VCP_LDDINVALID
;
479 /* search until we find the appropriate LDD or hit the end */
480 while ((pCurr
!= NULL
) && (ldid
> pCurr
->pldd
->ldid
))
485 if ( (pCurr
== NULL
) /* hit end of list */
486 || (ldid
!= pCurr
->pldd
->ldid
) )
487 return ERR_VCP_LDDFIND
; /* correct ? */
489 /* ok, found our victim: eliminate it */
492 pPrev
->next
= pCurr
->next
;
494 if (pCurr
== pFirstLDD
)
496 HeapFree(GetProcessHeap(), 0, pCurr
);
501 /***********************************************************************
502 * CtlDelLdd (SETUPX.37)
504 RETERR16 WINAPI
CtlDelLdd16(LOGDISKID16 ldid
)
506 FIXME("(%d); - please report this!\n", ldid
);
507 return SETUPX_DelLdd(ldid
);
510 /***********************************************************************
511 * CtlFindLdd (SETUPX.35)
513 * doesn't check pldd ptr validity: crash (W98SE)
516 * ERR_VCP_LDDINVALID if pldd->cbSize != structsize
517 * 1 in all other cases ??
520 RETERR16 WINAPI
CtlFindLdd16(LPLOGDISKDESC pldd
)
522 LDD_LIST
*pCurr
, *pPrev
= NULL
;
524 TRACE("(%p)\n", pldd
);
527 SETUPX_CreateStandardLDDs();
529 if (pldd
->cbSize
!= sizeof(LOGDISKDESC_S
))
530 return ERR_VCP_LDDINVALID
;
533 /* search until we find the appropriate LDD or hit the end */
534 while ((pCurr
!= NULL
) && (pldd
->ldid
> pCurr
->pldd
->ldid
))
539 if ( (pCurr
== NULL
) /* hit end of list */
540 || (pldd
->ldid
!= pCurr
->pldd
->ldid
) )
541 return ERR_VCP_LDDFIND
; /* correct ? */
543 memcpy(pldd
, pCurr
->pldd
, pldd
->cbSize
);
544 /* hmm, we probably ought to strcpy() the string ptrs here */
546 return 1; /* what is this ?? */
549 /***********************************************************************
550 * CtlSetLdd (SETUPX.33)
555 * ERR_VCP_LDDINVALID if pldd.cbSize != sizeof(LOGDISKDESC_S)
558 RETERR16 WINAPI
CtlSetLdd16(LPLOGDISKDESC pldd
)
560 LDD_LIST
*pCurr
, *pPrev
= NULL
;
561 LPLOGDISKDESC pCurrLDD
;
565 TRACE("(%p)\n", pldd
);
568 SETUPX_CreateStandardLDDs();
570 if (pldd
->cbSize
!= sizeof(LOGDISKDESC_S
))
571 return ERR_VCP_LDDINVALID
;
573 heap
= GetProcessHeap();
575 /* search until we find the appropriate LDD or hit the end */
576 while ((pCurr
!= NULL
) && (pldd
->ldid
> pCurr
->pldd
->ldid
))
581 if (!pCurr
|| pldd
->ldid
!= pCurr
->pldd
->ldid
)
584 pCurr
= HeapAlloc(heap
, 0, sizeof(LDD_LIST
));
585 pCurr
->pldd
= HeapAlloc(heap
, 0, sizeof(LOGDISKDESC_S
));
587 pCurrLDD
= pCurr
->pldd
;
591 pCurrLDD
= pCurr
->pldd
;
592 if (pCurrLDD
->pszPath
) HeapFree(heap
, 0, pCurrLDD
->pszPath
);
593 if (pCurrLDD
->pszVolLabel
) HeapFree(heap
, 0, pCurrLDD
->pszVolLabel
);
594 if (pCurrLDD
->pszDiskName
) HeapFree(heap
, 0, pCurrLDD
->pszDiskName
);
597 memcpy(pCurrLDD
, pldd
, sizeof(LOGDISKDESC_S
));
601 pCurrLDD
->pszPath
= HeapAlloc( heap
, 0, strlen(pldd
->pszPath
)+1 );
602 strcpy( pCurrLDD
->pszPath
, pldd
->pszPath
);
604 if (pldd
->pszVolLabel
)
606 pCurrLDD
->pszVolLabel
= HeapAlloc( heap
, 0, strlen(pldd
->pszVolLabel
)+1 );
607 strcpy( pCurrLDD
->pszVolLabel
, pldd
->pszVolLabel
);
609 if (pldd
->pszDiskName
)
611 pCurrLDD
->pszDiskName
= HeapAlloc( heap
, 0, strlen(pldd
->pszDiskName
)+1 );
612 strcpy( pCurrLDD
->pszDiskName
, pldd
->pszDiskName
);
615 if (is_new
) /* link into list */
619 pCurr
->next
= pPrev
->next
;
630 /***********************************************************************
631 * CtlAddLdd (SETUPX.36)
633 * doesn't check pldd ptr validity: crash (W98SE)
636 static LOGDISKID16 ldid_to_add
= LDID_ASSIGN_START
;
637 RETERR16 WINAPI
CtlAddLdd16(LPLOGDISKDESC pldd
)
639 pldd
->ldid
= ldid_to_add
++;
640 return CtlSetLdd16(pldd
);
643 /***********************************************************************
644 * CtlGetLdd (SETUPX.34)
646 * doesn't check pldd ptr validity: crash (W98SE)
647 * What the !@#$%&*( is the difference between CtlFindLdd() and CtlGetLdd() ??
650 * ERR_VCP_LDDINVALID if pldd->cbSize != structsize
653 static RETERR16
SETUPX_GetLdd(LPLOGDISKDESC pldd
)
655 LDD_LIST
*pCurr
, *pPrev
= NULL
;
658 SETUPX_CreateStandardLDDs();
660 if (pldd
->cbSize
!= sizeof(LOGDISKDESC_S
))
661 return ERR_VCP_LDDINVALID
;
664 /* search until we find the appropriate LDD or hit the end */
665 while ((pCurr
!= NULL
) && (pldd
->ldid
> pCurr
->pldd
->ldid
))
670 if (pCurr
== NULL
) /* hit end of list */
671 return ERR_VCP_LDDFIND
; /* correct ? */
673 memcpy(pldd
, pCurr
->pldd
, pldd
->cbSize
);
674 /* hmm, we probably ought to strcpy() the string ptrs here */
679 /**********************************************************************/
681 RETERR16 WINAPI
CtlGetLdd16(LPLOGDISKDESC pldd
)
683 FIXME("(%p); - please report this!\n", pldd
);
684 return SETUPX_GetLdd(pldd
);
687 /***********************************************************************
688 * CtlGetLddPath (SETUPX.38)
690 * Gets the path of an LDD.
691 * No crash if szPath == NULL.
692 * szPath has to be at least MAX_PATH_LEN bytes long.
694 * ERR_VCP_LDDUNINIT if LDD for LDID not found.
696 RETERR16 WINAPI
CtlGetLddPath16(LOGDISKID16 ldid
, LPSTR szPath
)
698 TRACE("(%d, %p);\n", ldid
, szPath
);
704 if (CtlFindLdd16(&ldd
) == ERR_VCP_LDDFIND
)
705 return ERR_VCP_LDDUNINIT
;
707 strcpy(szPath
, ldd
.pszPath
);
708 TRACE("ret '%s' for LDID %d\n", szPath
, ldid
);
713 /***********************************************************************
714 * CtlSetLddPath (SETUPX.508)
716 * Sets the path of an LDD.
717 * Creates LDD for LDID if not existing yet.
719 RETERR16 WINAPI
CtlSetLddPath16(LOGDISKID16 ldid
, LPSTR szPath
)
722 TRACE("(%d, '%s');\n", ldid
, szPath
);
724 SetupSetDirectoryIdA( 0, ldid
, szPath
);
726 ldd
.pszPath
= szPath
;
727 return CtlSetLdd16(&ldd
);