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 /***********************************************************************
74 * SURegOpenKey (SETUPX.47)
76 DWORD WINAPI
SURegOpenKey( HKEY hkey
, LPCSTR lpszSubKey
, PHKEY retkey
)
78 FIXME("(%p,%s,%p), semi-stub.\n",hkey
,debugstr_a(lpszSubKey
),retkey
);
79 return RegOpenKeyA( hkey
, lpszSubKey
, retkey
);
82 /***********************************************************************
83 * SURegQueryValueEx (SETUPX.50)
85 DWORD WINAPI
SURegQueryValueEx( HKEY hkey
, LPSTR lpszValueName
,
86 LPDWORD lpdwReserved
, LPDWORD lpdwType
,
87 LPBYTE lpbData
, LPDWORD lpcbData
)
89 FIXME("(%p,%s,%p,%p,%p,%ld), semi-stub.\n",hkey
,debugstr_a(lpszValueName
),
90 lpdwReserved
,lpdwType
,lpbData
,lpcbData
?*lpcbData
:0);
91 return RegQueryValueExA( hkey
, lpszValueName
, lpdwReserved
, lpdwType
,
95 /***********************************************************************
96 * TPWriteProfileString (SETUPX.62)
98 BOOL WINAPI
TPWriteProfileString16( LPCSTR section
, LPCSTR entry
, LPCSTR string
)
100 FIXME( "%s %s %s: stub\n", debugstr_a(section
), debugstr_a(entry
), debugstr_a(string
) );
105 /***********************************************************************
106 * suErrorToIds (SETUPX.61)
108 DWORD WINAPI
suErrorToIds16( WORD w1
, WORD w2
)
110 FIXME( "%x %x: stub\n", w1
, w2
);
114 /***********************************************************************
115 * InstallHinfSection (SETUPX.527)
117 * hwnd = parent window
118 * hinst = instance of SETUPX.DLL
119 * lpszCmdLine = e.g. "DefaultInstall 132 C:\MYINSTALL\MYDEV.INF"
120 * Here "DefaultInstall" is the .inf file section to be installed (optional).
121 * The 132 value is made of the HOW_xxx flags and sometimes 128 (-> setupx16.h).
123 * nCmdShow = nCmdShow of CreateProcess
125 RETERR16 WINAPI
InstallHinfSection16( HWND16 hwnd
, HINSTANCE16 hinst
, LPCSTR lpszCmdLine
, INT16 nCmdShow
)
127 InstallHinfSectionA( HWND_32(hwnd
), 0, lpszCmdLine
, nCmdShow
);
134 LPCSTR StdString
; /* fallback string; sub dir of windows directory */
137 static const LDID_DATA LDID_Data
[34] =
139 { /* 0 (LDID_NULL) -- not defined */
143 { /* 1 (LDID_SRCPATH) = source of installation. hmm, what to do here ? */
144 "SourcePath", /* hmm, does SETUPX have to care about updating it ?? */
147 { /* 2 (LDID_SETUPTEMP) = setup temp dir */
151 { /* 3 (LDID_UNINSTALL) = uninstall backup dir */
155 { /* 4 (LDID_BACKUP) = backup dir */
159 { /* 5 (LDID_SETUPSCRATCH) = setup scratch dir */
163 { /* 6 -- not defined */
167 { /* 7 -- not defined */
171 { /* 8 -- not defined */
175 { /* 9 -- not defined */
179 { /* 10 (LDID_WIN) = windows dir */
183 { /* 11 (LDID_SYS) = system dir */
185 NULL
/* call GetSystemDirectory() instead */
187 { /* 12 (LDID_IOS) = IOSubSys dir */
188 NULL
, /* FIXME: registry string ? */
191 { /* 13 (LDID_CMD) = COMMAND dir */
192 NULL
, /* FIXME: registry string ? */
195 { /* 14 (LDID_CPL) = control panel dir */
199 { /* 15 (LDID_PRINT) = windows printer dir */
201 "SYSTEM" /* correct ?? */
203 { /* 16 (LDID_MAIL) = destination mail dir */
207 { /* 17 (LDID_INF) = INF dir */
208 "SetupScratchDir", /* correct ? */
211 { /* 18 (LDID_HELP) = HELP dir */
215 { /* 19 (LDID_WINADMIN) = Admin dir */
219 { /* 20 (LDID_FONTS) = Fonts dir */
223 { /* 21 (LDID_VIEWERS) = Viewers */
227 { /* 22 (LDID_VMM32) = VMM32 dir */
231 { /* 23 (LDID_COLOR) = ICM dir */
235 { /* 24 (LDID_APPS) = root of boot drive ? */
239 { /* 25 (LDID_SHARED) = shared dir */
243 { /* 26 (LDID_WINBOOT) = Windows boot dir */
247 { /* 27 (LDID_MACHINE) = machine specific files */
251 { /* 28 (LDID_HOST_WINBOOT) = Host Windows boot dir */
255 { /* 29 -- not defined */
259 { /* 30 (LDID_BOOT) = Root of boot drive */
263 { /* 31 (LDID_BOOT_HOST) = Root of boot drive host */
267 { /* 32 (LDID_OLD_WINBOOT) = subdir of root */
271 { /* 33 (LDID_OLD_WIN) = old win dir */
275 /* the rest (34-38) isn't too interesting, so I'll forget about it */
279 * LDD == Logical Device Descriptor
280 * LDID == Logical Device ID
282 * The whole LDD/LDID business might go into a separate file named
284 * At the moment I don't know what the hell these functions are really doing.
285 * That's why I added reporting stubs.
286 * The only thing I do know is that I need them for the LDD/LDID infrastructure.
287 * That's why I implemented them in a way that's suitable for my purpose.
289 static LDD_LIST
*pFirstLDD
= NULL
;
291 static BOOL std_LDDs_done
= FALSE
;
293 static void SETUPX_CreateStandardLDDs(void)
299 char buffer
[MAX_PATH
];
301 /* has to be here, otherwise loop */
302 std_LDDs_done
= TRUE
;
304 RegOpenKeyA(HKEY_LOCAL_MACHINE
, "SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Setup", &hKey
);
306 for (n
=0; n
< ARRAY_SIZE(LDID_Data
); n
++)
311 if ( (hKey
) && (LDID_Data
[n
].RegValName
)
312 && (RegQueryValueExA(hKey
, LDID_Data
[n
].RegValName
,
313 NULL
, &type
, (LPBYTE
)buffer
, &len
) == ERROR_SUCCESS
)
314 && (type
== REG_SZ
) )
316 TRACE("found value '%s' for LDID %d\n", buffer
, n
);
322 FIXME("LDID_SRCPATH: what exactly do we have to do here ?\n");
323 strcpy(buffer
, "X:\\FIXME");
326 GetSystemDirectoryA(buffer
, MAX_PATH
);
330 case LDID_HOST_WINBOOT
:
333 strcpy(buffer
, "C:\\");
336 if (LDID_Data
[n
].StdString
)
338 DWORD len
= GetWindowsDirectoryA(buffer
, MAX_PATH
);
342 strcpy(p
, LDID_Data
[n
].StdString
);
349 ldd
.pszPath
= buffer
;
350 TRACE("LDID %d -> '%s'\n", ldd
.ldid
, ldd
.pszPath
);
354 if (hKey
) RegCloseKey(hKey
);
357 /***********************************************************************
358 * CtlDelLdd (SETUPX.37)
361 * ERR_VCP_LDDINVALID if ldid < LDID_ASSIGN_START.
363 static RETERR16
SETUPX_DelLdd(LOGDISKID16 ldid
)
365 LDD_LIST
*pCurr
, *pPrev
= NULL
;
367 TRACE("(%d)\n", ldid
);
370 SETUPX_CreateStandardLDDs();
372 if (ldid
< LDID_ASSIGN_START
)
373 return ERR_VCP_LDDINVALID
;
376 /* search until we find the appropriate LDD or hit the end */
377 while ((pCurr
!= NULL
) && (ldid
> pCurr
->pldd
->ldid
))
382 if ( (pCurr
== NULL
) /* hit end of list */
383 || (ldid
!= pCurr
->pldd
->ldid
) )
384 return ERR_VCP_LDDFIND
; /* correct ? */
386 /* ok, found our victim: eliminate it */
389 pPrev
->next
= pCurr
->next
;
391 if (pCurr
== pFirstLDD
)
393 HeapFree(GetProcessHeap(), 0, pCurr
);
398 /***********************************************************************
399 * CtlDelLdd (SETUPX.37)
401 RETERR16 WINAPI
CtlDelLdd16(LOGDISKID16 ldid
)
403 FIXME("(%d); - please report this!\n", ldid
);
404 return SETUPX_DelLdd(ldid
);
407 /***********************************************************************
408 * CtlFindLdd (SETUPX.35)
410 * doesn't check pldd ptr validity: crash (W98SE)
413 * ERR_VCP_LDDINVALID if pldd->cbSize != structsize
414 * 1 in all other cases ??
417 RETERR16 WINAPI
CtlFindLdd16(LPLOGDISKDESC pldd
)
421 TRACE("(%p)\n", pldd
);
424 SETUPX_CreateStandardLDDs();
426 if (pldd
->cbSize
!= sizeof(LOGDISKDESC_S
))
427 return ERR_VCP_LDDINVALID
;
430 /* search until we find the appropriate LDD or hit the end */
431 while ((pCurr
!= NULL
) && (pldd
->ldid
> pCurr
->pldd
->ldid
))
433 if ( (pCurr
== NULL
) /* hit end of list */
434 || (pldd
->ldid
!= pCurr
->pldd
->ldid
) )
435 return ERR_VCP_LDDFIND
; /* correct ? */
437 memcpy(pldd
, pCurr
->pldd
, pldd
->cbSize
);
438 /* hmm, we probably ought to strcpy() the string ptrs here */
440 return 1; /* what is this ?? */
443 /***********************************************************************
444 * CtlSetLdd (SETUPX.33)
449 * ERR_VCP_LDDINVALID if pldd.cbSize != sizeof(LOGDISKDESC_S)
452 RETERR16 WINAPI
CtlSetLdd16(LPLOGDISKDESC pldd
)
454 LDD_LIST
*pCurr
, *pPrev
= NULL
;
455 LPLOGDISKDESC pCurrLDD
;
459 TRACE("(%p)\n", pldd
);
462 SETUPX_CreateStandardLDDs();
464 if (pldd
->cbSize
!= sizeof(LOGDISKDESC_S
))
465 return ERR_VCP_LDDINVALID
;
467 heap
= GetProcessHeap();
469 /* search until we find the appropriate LDD or hit the end */
470 while ((pCurr
!= NULL
) && (pldd
->ldid
> pCurr
->pldd
->ldid
))
475 if (!pCurr
|| pldd
->ldid
!= pCurr
->pldd
->ldid
)
478 pCurr
= HeapAlloc(heap
, 0, sizeof(LDD_LIST
));
479 pCurr
->pldd
= HeapAlloc(heap
, 0, sizeof(LOGDISKDESC_S
));
481 pCurrLDD
= pCurr
->pldd
;
485 pCurrLDD
= pCurr
->pldd
;
486 HeapFree(heap
, 0, pCurrLDD
->pszPath
);
487 HeapFree(heap
, 0, pCurrLDD
->pszVolLabel
);
488 HeapFree(heap
, 0, pCurrLDD
->pszDiskName
);
495 pCurrLDD
->pszPath
= HeapAlloc( heap
, 0, strlen(pldd
->pszPath
)+1 );
496 strcpy( pCurrLDD
->pszPath
, pldd
->pszPath
);
498 if (pldd
->pszVolLabel
)
500 pCurrLDD
->pszVolLabel
= HeapAlloc( heap
, 0, strlen(pldd
->pszVolLabel
)+1 );
501 strcpy( pCurrLDD
->pszVolLabel
, pldd
->pszVolLabel
);
503 if (pldd
->pszDiskName
)
505 pCurrLDD
->pszDiskName
= HeapAlloc( heap
, 0, strlen(pldd
->pszDiskName
)+1 );
506 strcpy( pCurrLDD
->pszDiskName
, pldd
->pszDiskName
);
509 if (is_new
) /* link into list */
513 pCurr
->next
= pPrev
->next
;
524 /***********************************************************************
525 * CtlAddLdd (SETUPX.36)
527 * doesn't check pldd ptr validity: crash (W98SE)
530 static LOGDISKID16 ldid_to_add
= LDID_ASSIGN_START
;
531 RETERR16 WINAPI
CtlAddLdd16(LPLOGDISKDESC pldd
)
533 pldd
->ldid
= ldid_to_add
++;
534 return CtlSetLdd16(pldd
);
537 /***********************************************************************
538 * CtlGetLdd (SETUPX.34)
540 * doesn't check pldd ptr validity: crash (W98SE)
541 * What the !@#$%&*( is the difference between CtlFindLdd() and CtlGetLdd() ??
544 * ERR_VCP_LDDINVALID if pldd->cbSize != structsize
547 static RETERR16
SETUPX_GetLdd(LPLOGDISKDESC pldd
)
552 SETUPX_CreateStandardLDDs();
554 if (pldd
->cbSize
!= sizeof(LOGDISKDESC_S
))
555 return ERR_VCP_LDDINVALID
;
558 /* search until we find the appropriate LDD or hit the end */
559 while ((pCurr
!= NULL
) && (pldd
->ldid
> pCurr
->pldd
->ldid
))
561 if (pCurr
== NULL
) /* hit end of list */
562 return ERR_VCP_LDDFIND
; /* correct ? */
564 memcpy(pldd
, pCurr
->pldd
, pldd
->cbSize
);
565 /* hmm, we probably ought to strcpy() the string ptrs here */
570 /**********************************************************************/
572 RETERR16 WINAPI
CtlGetLdd16(LPLOGDISKDESC pldd
)
574 FIXME("(%p); - please report this!\n", pldd
);
575 return SETUPX_GetLdd(pldd
);
578 /***********************************************************************
579 * CtlGetLddPath (SETUPX.38)
581 * Gets the path of an LDD.
582 * No crash if szPath == NULL.
583 * szPath has to be at least MAX_PATH_LEN bytes long.
585 * ERR_VCP_LDDUNINIT if LDD for LDID not found.
587 RETERR16 WINAPI
CtlGetLddPath16(LOGDISKID16 ldid
, LPSTR szPath
)
589 TRACE("(%d, %p);\n", ldid
, szPath
);
595 if (CtlFindLdd16(&ldd
) == ERR_VCP_LDDFIND
)
596 return ERR_VCP_LDDUNINIT
;
598 strcpy(szPath
, ldd
.pszPath
);
599 TRACE("ret '%s' for LDID %d\n", szPath
, ldid
);
604 /***********************************************************************
605 * DiInstallClass (SETUPX.321)
607 * Install Class from an INF file (in [ClassInstall] section)
609 RETERR16 WINAPI
DiInstallClass16(LPCSTR lpszInfFileName
, DWORD dwFlags
)
611 FIXME("(%s, %lu), stub.\n", lpszInfFileName
, dwFlags
);
615 /***********************************************************************
616 * CtlSetLddPath (SETUPX.508)
618 * Sets the path of an LDD.
619 * Creates LDD for LDID if not existing yet.
621 RETERR16 WINAPI
CtlSetLddPath16(LOGDISKID16 ldid
, LPSTR szPath
)
624 TRACE("(%d, '%s');\n", ldid
, szPath
);
626 SetupSetDirectoryIdA( 0, ldid
, szPath
);
628 ldd
.pszPath
= szPath
;
629 return CtlSetLdd16(&ldd
);
632 /***********************************************************************
633 * DiBuildDriverIndex (SETUPX.412)
635 RETERR16 WINAPI
DiBuildDriverIndex16( WORD w1
)
637 FIXME( "%x: stub\n", w1
);