diff --git a/dlls/advpack/advpack.c b/dlls/advpack/advpack.c index 45bdbe65d93..29519005c48 100644 --- a/dlls/advpack/advpack.c +++ b/dlls/advpack/advpack.c @@ -126,6 +126,8 @@ HRESULT WINAPI RunSetupCommand( HWND hWnd, LPCSTR szCmdName, /*********************************************************************** * LaunchINFSection (ADVPACK.@) + * + * See LaunchINFSectionEx. */ INT WINAPI LaunchINFSection( HWND hWnd, HINSTANCE hInst, LPSTR cmdline, INT show ) { @@ -135,6 +137,21 @@ INT WINAPI LaunchINFSection( HWND hWnd, HINSTANCE hInst, LPSTR cmdline, INT show /*********************************************************************** * LaunchINFSectionEx (ADVPACK.@) + * + * Installs an INF section. + * + * PARAMS + * hWnd [I] Handle to the window used for the display. + * hInst [I] Instance of the process. + * cmdline [I] Contains parameters in the order INF,section,CAB,flags. + * show [I] How the window should be shown. + * + * RETURNS + * Success: S_OK. + * Failure: E_FAIL. + * + * BUGS + * Unimplemented. */ HRESULT WINAPI LaunchINFSectionEx( HWND hWnd, HINSTANCE hInst, LPSTR cmdline, INT show ) { @@ -181,6 +198,18 @@ BOOL WINAPI DoInfInstall(const SETUPCOMMAND_PARAMS *setup) /*********************************************************************** * IsNTAdmin (ADVPACK.@) + * + * Checks if the user has admin privileges. + * + * PARAMS + * reserved [I] Reserved. Must be 0. + * pReserved [I] Reserved. Must be NULL. + * + * RETURNS + * TRUE if user has admin rights, FALSE otherwise. + * + * BUGS + * Unimplemented. */ BOOL WINAPI IsNTAdmin( DWORD reserved, LPDWORD pReserved ) { @@ -190,6 +219,11 @@ BOOL WINAPI IsNTAdmin( DWORD reserved, LPDWORD pReserved ) /*********************************************************************** * NeedRebootInit (ADVPACK.@) + * + * Sets up conditions for reboot checking. + * + * RETURNS + * Value required by NeedReboot. */ DWORD WINAPI NeedRebootInit(VOID) { @@ -199,6 +233,17 @@ DWORD WINAPI NeedRebootInit(VOID) /*********************************************************************** * NeedReboot (ADVPACK.@) + * + * Determines whether a reboot is required. + * + * PARAMS + * dwRebootCheck [I] Value from NeedRebootInit. + * + * RETURNS + * TRUE if a reboot is needed, FALSE otherwise. + * + * BUGS + * Unimplemented. */ BOOL WINAPI NeedReboot(DWORD dwRebootCheck) { @@ -208,6 +253,8 @@ BOOL WINAPI NeedReboot(DWORD dwRebootCheck) /*********************************************************************** * GetVersionFromFile (ADVPACK.@) + * + * See GetVersionFromFileEx. */ HRESULT WINAPI GetVersionFromFile( LPSTR Filename, LPDWORD MajorVer, LPDWORD MinorVer, BOOL Version ) @@ -225,6 +272,21 @@ typedef struct tagLANGANDCODEPAGE /*********************************************************************** * GetVersionFromFileEx (ADVPACK.@) + * + * Gets the files version or language information. + * + * PARAMS + * lpszFilename [I] The file to get the info from. + * pdwMSVer [O] Major version. + * pdwLSVer [O] Minor version. + * bVersion [I] Whether to retrieve version or language info. + * + * RETURNS + * Always returns S_OK. + * + * NOTES + * If bVersion is TRUE, version information is retrieved, else + * pdwMSVer gets the language ID and pdwLSVer gets the codepage ID. */ HRESULT WINAPI GetVersionFromFileEx( LPSTR lpszFilename, LPDWORD pdwMSVer, LPDWORD pdwLSVer, BOOL bVersion ) @@ -452,6 +514,18 @@ HRESULT WINAPI DelNode( LPCSTR pszFileOrDirName, DWORD dwFlags ) /*********************************************************************** * DelNodeRunDLL32 (ADVPACK.@) * + * Deletes a file or directory, WinMain style. + * + * PARAMS + * hWnd [I] Handle to the window used for the display. + * hInst [I] Instance of the process. + * cmdline [I] Contains parameters in the order FileOrDirName,Flags. + * show [I] How the window should be shown. + * + * RETURNS + * Success: S_OK. + * Failure: E_FAIL. + * * BUGS * Unimplemented */