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., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, 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)
26 * http://mmatrix.tripod.com/customsystemfolder/infsysntaxfull.html
27 * http://www.rdrop.com/~cary/html/inf_faq.html
30 * - rs405deu.exe (German Acroread 4.05 setup)
35 * - string handling is... weird ;) (buflen etc.)
37 * - separate that mess (but probably only when it's done completely)
39 * SETUPX consists of several parts with the following acronyms/prefixes:
40 * Di device installer (devinst.c ?)
41 * Gen generic installer (geninst.c ?)
42 * Ip .INF parsing (infparse.c)
43 * LDD logical device descriptor (ldd.c ?)
44 * LDID logical device ID
45 * SU setup (setup.c ?)
46 * Tp text processing (textproc.c ?)
47 * Vcp virtual copy module (vcp.c ?)
50 * The SETUPX DLL is NOT thread-safe. That's why many installers urge you to
51 * "close all open applications".
52 * All in all the design of it seems to be a bit weak.
53 * Not sure whether my implementation of it is better, though ;-)
69 #include "wine/debug.h"
71 WINE_DEFAULT_DEBUG_CHANNEL(setupapi);
73 #define HINSTANCE_32(h16) ((HINSTANCE)(ULONG_PTR)(h16))
75 /***********************************************************************
76 * SURegOpenKey (SETUPX.47)
78 DWORD WINAPI SURegOpenKey( HKEY hkey, LPCSTR lpszSubKey, PHKEY retkey )
80 FIXME("(%p,%s,%p), semi-stub.\n",hkey,debugstr_a(lpszSubKey),retkey);
81 return RegOpenKeyA( hkey, lpszSubKey, retkey );
84 /***********************************************************************
85 * SURegQueryValueEx (SETUPX.50)
87 DWORD WINAPI SURegQueryValueEx( HKEY hkey, LPSTR lpszValueName,
88 LPDWORD lpdwReserved, LPDWORD lpdwType,
89 LPBYTE lpbData, LPDWORD lpcbData )
91 FIXME("(%p,%s,%p,%p,%p,%d), semi-stub.\n",hkey,debugstr_a(lpszValueName),
92 lpdwReserved,lpdwType,lpbData,lpcbData?*lpcbData:0);
93 return RegQueryValueExA( hkey, lpszValueName, lpdwReserved, lpdwType,
97 /***********************************************************************
98 * TPWriteProfileString (SETUPX.62)
100 BOOL WINAPI TPWriteProfileString16( LPCSTR section, LPCSTR entry, LPCSTR string )
102 FIXME( "%s %s %s: stub\n", debugstr_a(section), debugstr_a(entry), debugstr_a(string) );
107 /***********************************************************************
108 * suErrorToIds (SETUPX.61)
110 DWORD WINAPI suErrorToIds16( WORD w1, WORD w2 )
112 FIXME( "%x %x: stub\n", w1, w2 );
116 /***********************************************************************
117 * InstallHinfSection (SETUPX.527)
119 * hwnd = parent window
120 * hinst = instance of SETUPX.DLL
121 * lpszCmdLine = e.g. "DefaultInstall 132 C:\MYINSTALL\MYDEV.INF"
122 * Here "DefaultInstall" is the .inf file section to be installed (optional).
123 * The 132 value is made of the HOW_xxx flags and sometimes 128 (-> setupx16.h).
125 * nCmdShow = nCmdShow of CreateProcess
127 RETERR16 WINAPI InstallHinfSection16( HWND16 hwnd, HINSTANCE16 hinst, LPCSTR lpszCmdLine, INT16 nCmdShow)
129 InstallHinfSectionA( HWND_32(hwnd), HINSTANCE_32(hinst), lpszCmdLine, nCmdShow );
136 LPCSTR StdString; /* fallback string; sub dir of windows directory */
139 static const LDID_DATA LDID_Data[34] =
141 { /* 0 (LDID_NULL) -- not defined */
145 { /* 1 (LDID_SRCPATH) = source of installation. hmm, what to do here ? */
146 "SourcePath", /* hmm, does SETUPX have to care about updating it ?? */
149 { /* 2 (LDID_SETUPTEMP) = setup temp dir */
153 { /* 3 (LDID_UNINSTALL) = uninstall backup dir */
157 { /* 4 (LDID_BACKUP) = backup dir */
161 { /* 5 (LDID_SETUPSCRATCH) = setup scratch dir */
165 { /* 6 -- not defined */
169 { /* 7 -- not defined */
173 { /* 8 -- not defined */
177 { /* 9 -- not defined */
181 { /* 10 (LDID_WIN) = windows dir */
185 { /* 11 (LDID_SYS) = system dir */
187 NULL /* call GetSystemDirectory() instead */
189 { /* 12 (LDID_IOS) = IOSubSys dir */
190 NULL, /* FIXME: registry string ? */
193 { /* 13 (LDID_CMD) = COMMAND dir */
194 NULL, /* FIXME: registry string ? */
197 { /* 14 (LDID_CPL) = control panel dir */
201 { /* 15 (LDID_PRINT) = windows printer dir */
203 "SYSTEM" /* correct ?? */
205 { /* 16 (LDID_MAIL) = destination mail dir */
209 { /* 17 (LDID_INF) = INF dir */
210 "SetupScratchDir", /* correct ? */
213 { /* 18 (LDID_HELP) = HELP dir */
217 { /* 19 (LDID_WINADMIN) = Admin dir */
221 { /* 20 (LDID_FONTS) = Fonts dir */
225 { /* 21 (LDID_VIEWERS) = Viewers */
229 { /* 22 (LDID_VMM32) = VMM32 dir */
233 { /* 23 (LDID_COLOR) = ICM dir */
237 { /* 24 (LDID_APPS) = root of boot drive ? */
241 { /* 25 (LDID_SHARED) = shared dir */
245 { /* 26 (LDID_WINBOOT) = Windows boot dir */
249 { /* 27 (LDID_MACHINE) = machine specific files */
253 { /* 28 (LDID_HOST_WINBOOT) = Host Windows boot dir */
257 { /* 29 -- not defined */
261 { /* 30 (LDID_BOOT) = Root of boot drive */
265 { /* 31 (LDID_BOOT_HOST) = Root of boot drive host */
269 { /* 32 (LDID_OLD_WINBOOT) = subdir of root */
273 { /* 33 (LDID_OLD_WIN) = old win dir */
277 /* the rest (34-38) isn't too interesting, so I'll forget about it */
281 * LDD == Logical Device Descriptor
282 * LDID == Logical Device ID
284 * The whole LDD/LDID business might go into a separate file named
286 * At the moment I don't know what the hell these functions are really doing.
287 * That's why I added reporting stubs.
288 * The only thing I do know is that I need them for the LDD/LDID infrastructure.
289 * That's why I implemented them in a way that's suitable for my purpose.
291 static LDD_LIST *pFirstLDD = NULL;
293 static BOOL std_LDDs_done = FALSE;
295 static void SETUPX_CreateStandardLDDs(void)
301 char buffer[MAX_PATH];
303 /* has to be here, otherwise loop */
304 std_LDDs_done = TRUE;
306 RegOpenKeyA(HKEY_LOCAL_MACHINE, "SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Setup", &hKey);
308 for (n=0; n < sizeof(LDID_Data)/sizeof(LDID_DATA); n++)
313 if ( (hKey) && (LDID_Data[n].RegValName)
314 && (RegQueryValueExA(hKey, LDID_Data[n].RegValName,
315 NULL, &type, (LPBYTE)buffer, &len) == ERROR_SUCCESS)
316 && (type == REG_SZ) )
318 TRACE("found value '%s' for LDID %d\n", buffer, n);
324 FIXME("LDID_SRCPATH: what exactly do we have to do here ?\n");
325 strcpy(buffer, "X:\\FIXME");
328 GetSystemDirectoryA(buffer, MAX_PATH);
332 case LDID_HOST_WINBOOT:
335 strcpy(buffer, "C:\\");
338 if (LDID_Data[n].StdString)
340 DWORD len = GetWindowsDirectoryA(buffer, MAX_PATH);
344 strcpy(p, LDID_Data[n].StdString);
351 ldd.pszPath = buffer;
352 TRACE("LDID %d -> '%s'\n", ldd.ldid, ldd.pszPath);
356 if (hKey) RegCloseKey(hKey);
359 /***********************************************************************
360 * CtlDelLdd (SETUPX.37)
363 * ERR_VCP_LDDINVALID if ldid < LDID_ASSIGN_START.
365 static RETERR16 SETUPX_DelLdd(LOGDISKID16 ldid)
367 LDD_LIST *pCurr, *pPrev = NULL;
369 TRACE("(%d)\n", ldid);
372 SETUPX_CreateStandardLDDs();
374 if (ldid < LDID_ASSIGN_START)
375 return ERR_VCP_LDDINVALID;
378 /* search until we find the appropriate LDD or hit the end */
379 while ((pCurr != NULL) && (ldid > pCurr->pldd->ldid))
384 if ( (pCurr == NULL) /* hit end of list */
385 || (ldid != pCurr->pldd->ldid) )
386 return ERR_VCP_LDDFIND; /* correct ? */
388 /* ok, found our victim: eliminate it */
391 pPrev->next = pCurr->next;
393 if (pCurr == pFirstLDD)
395 HeapFree(GetProcessHeap(), 0, pCurr);
400 /***********************************************************************
401 * CtlDelLdd (SETUPX.37)
403 RETERR16 WINAPI CtlDelLdd16(LOGDISKID16 ldid)
405 FIXME("(%d); - please report this!\n", ldid);
406 return SETUPX_DelLdd(ldid);
409 /***********************************************************************
410 * CtlFindLdd (SETUPX.35)
412 * doesn't check pldd ptr validity: crash (W98SE)
415 * ERR_VCP_LDDINVALID if pldd->cbSize != structsize
416 * 1 in all other cases ??
419 RETERR16 WINAPI CtlFindLdd16(LPLOGDISKDESC pldd)
423 TRACE("(%p)\n", pldd);
426 SETUPX_CreateStandardLDDs();
428 if (pldd->cbSize != sizeof(LOGDISKDESC_S))
429 return ERR_VCP_LDDINVALID;
432 /* search until we find the appropriate LDD or hit the end */
433 while ((pCurr != NULL) && (pldd->ldid > pCurr->pldd->ldid))
435 if ( (pCurr == NULL) /* hit end of list */
436 || (pldd->ldid != pCurr->pldd->ldid) )
437 return ERR_VCP_LDDFIND; /* correct ? */
439 memcpy(pldd, pCurr->pldd, pldd->cbSize);
440 /* hmm, we probably ought to strcpy() the string ptrs here */
442 return 1; /* what is this ?? */
445 /***********************************************************************
446 * CtlSetLdd (SETUPX.33)
451 * ERR_VCP_LDDINVALID if pldd.cbSize != sizeof(LOGDISKDESC_S)
454 RETERR16 WINAPI CtlSetLdd16(LPLOGDISKDESC pldd)
456 LDD_LIST *pCurr, *pPrev = NULL;
457 LPLOGDISKDESC pCurrLDD;
461 TRACE("(%p)\n", pldd);
464 SETUPX_CreateStandardLDDs();
466 if (pldd->cbSize != sizeof(LOGDISKDESC_S))
467 return ERR_VCP_LDDINVALID;
469 heap = GetProcessHeap();
471 /* search until we find the appropriate LDD or hit the end */
472 while ((pCurr != NULL) && (pldd->ldid > pCurr->pldd->ldid))
477 if (!pCurr || pldd->ldid != pCurr->pldd->ldid)
480 pCurr = HeapAlloc(heap, 0, sizeof(LDD_LIST));
481 pCurr->pldd = HeapAlloc(heap, 0, sizeof(LOGDISKDESC_S));
483 pCurrLDD = pCurr->pldd;
487 pCurrLDD = pCurr->pldd;
488 HeapFree(heap, 0, pCurrLDD->pszPath);
489 HeapFree(heap, 0, pCurrLDD->pszVolLabel);
490 HeapFree(heap, 0, pCurrLDD->pszDiskName);
497 pCurrLDD->pszPath = HeapAlloc( heap, 0, strlen(pldd->pszPath)+1 );
498 strcpy( pCurrLDD->pszPath, pldd->pszPath );
500 if (pldd->pszVolLabel)
502 pCurrLDD->pszVolLabel = HeapAlloc( heap, 0, strlen(pldd->pszVolLabel)+1 );
503 strcpy( pCurrLDD->pszVolLabel, pldd->pszVolLabel );
505 if (pldd->pszDiskName)
507 pCurrLDD->pszDiskName = HeapAlloc( heap, 0, strlen(pldd->pszDiskName)+1 );
508 strcpy( pCurrLDD->pszDiskName, pldd->pszDiskName );
511 if (is_new) /* link into list */
515 pCurr->next = pPrev->next;
526 /***********************************************************************
527 * CtlAddLdd (SETUPX.36)
529 * doesn't check pldd ptr validity: crash (W98SE)
532 static LOGDISKID16 ldid_to_add = LDID_ASSIGN_START;
533 RETERR16 WINAPI CtlAddLdd16(LPLOGDISKDESC pldd)
535 pldd->ldid = ldid_to_add++;
536 return CtlSetLdd16(pldd);
539 /***********************************************************************
540 * CtlGetLdd (SETUPX.34)
542 * doesn't check pldd ptr validity: crash (W98SE)
543 * What the !@#$%&*( is the difference between CtlFindLdd() and CtlGetLdd() ??
546 * ERR_VCP_LDDINVALID if pldd->cbSize != structsize
549 static RETERR16 SETUPX_GetLdd(LPLOGDISKDESC pldd)
554 SETUPX_CreateStandardLDDs();
556 if (pldd->cbSize != sizeof(LOGDISKDESC_S))
557 return ERR_VCP_LDDINVALID;
560 /* search until we find the appropriate LDD or hit the end */
561 while ((pCurr != NULL) && (pldd->ldid > pCurr->pldd->ldid))
563 if (pCurr == NULL) /* hit end of list */
564 return ERR_VCP_LDDFIND; /* correct ? */
566 memcpy(pldd, pCurr->pldd, pldd->cbSize);
567 /* hmm, we probably ought to strcpy() the string ptrs here */
572 /**********************************************************************/
574 RETERR16 WINAPI CtlGetLdd16(LPLOGDISKDESC pldd)
576 FIXME("(%p); - please report this!\n", pldd);
577 return SETUPX_GetLdd(pldd);
580 /***********************************************************************
581 * CtlGetLddPath (SETUPX.38)
583 * Gets the path of an LDD.
584 * No crash if szPath == NULL.
585 * szPath has to be at least MAX_PATH_LEN bytes long.
587 * ERR_VCP_LDDUNINIT if LDD for LDID not found.
589 RETERR16 WINAPI CtlGetLddPath16(LOGDISKID16 ldid, LPSTR szPath)
591 TRACE("(%d, %p);\n", ldid, szPath);
597 if (CtlFindLdd16(&ldd) == ERR_VCP_LDDFIND)
598 return ERR_VCP_LDDUNINIT;
600 strcpy(szPath, ldd.pszPath);
601 TRACE("ret '%s' for LDID %d\n", szPath, ldid);
606 /***********************************************************************
607 * DiInstallClass (SETUPX.321)
609 * Install Class from an INF file (in [ClassInstall] section)
611 RETERR16 WINAPI DiInstallClass16(LPCSTR lpszInfFileName, DWORD dwFlags)
613 FIXME("(%s, %u), stub.\n", lpszInfFileName, dwFlags);
617 /***********************************************************************
618 * CtlSetLddPath (SETUPX.508)
620 * Sets the path of an LDD.
621 * Creates LDD for LDID if not existing yet.
623 RETERR16 WINAPI CtlSetLddPath16(LOGDISKID16 ldid, LPSTR szPath)
626 TRACE("(%d, '%s');\n", ldid, szPath);
628 SetupSetDirectoryIdA( 0, ldid, szPath );
630 ldd.pszPath = szPath;
631 return CtlSetLdd16(&ldd);