DllInstall-Funktion (shlwapi.h)

Artikel
03/04/2024

Übernimmt die Installation und Einrichtung für eine DLL.

Syntax

HRESULT DllInstall(
                 BOOL   bInstall,
  [in, optional] PCWSTR pszCmdLine
);

Parameter

bInstall

Typ: BOOL

TRUE , wenn die DLL installiert wird; FALSE , wenn es deinstalliert wird.

[in, optional] pszCmdLine

Typ: PCWSTR

Eine von regsvr32 übergebene Zeichenfolge, die angibt, welche Setupprozedur verwendet werden soll. Dieser Wert kann NULL sein.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Funktion kann anhand des Namens von einer DLL implementiert und exportiert werden, um sie während der Anwendungsinstallation oder -einrichtung zu verwenden. Sie wird von regsvr32 aufgerufen, damit die DLL Aufgaben ausführen kann, z. B. das Hinzufügen von Informationen zur Registrierung.

DllInstall wird nur für die Installation und Einrichtung von Anwendungen verwendet. Sie sollte nicht von einer Anwendung aufgerufen werden. Es ist ähnlich wie DllRegisterServer oder DllUnregisterServer. Im Gegensatz zu diesen Funktionen verwendet DllInstall eine Eingabezeichenfolge, die verwendet werden kann, um eine Vielzahl verschiedener Aktionen anzugeben. Dies ermöglicht es, eine DLL auf mehrere Weise zu installieren, basierend auf allen geeigneten Kriterien.

Um DllInstall mit regsvr32 zu verwenden, fügen Sie ein Flag "/i" gefolgt von einem Doppelpunkt (:) und einer Zeichenfolge hinzu. Die Zeichenfolge wird als pszCmdLine-Parameter an DllInstall übergeben. Wenn Sie den Doppelpunkt und die Zeichenfolge weglassen, wird pszCmdLine auf NULL festgelegt. Im folgenden Beispiel wird eine DLL installiert.

regsvr32 /i:"Install_1" dllname.dll

DllInstall wird aufgerufen, wobei bInstall auf TRUE und pszCmdLine auf "Install_1" festgelegt ist. Verwenden Sie Folgendes, um eine DLL zu deinstallieren:

regsvr32 /u /i:"Install_1" dllname.dll

In beiden obigen Beispielen wird auch DllRegisterServer oder DllUnregisterServer aufgerufen. Um nur DllInstall aufzurufen, fügen Sie ein Flag "/n" hinzu.

regsvr32 /n /i:"Install_1" dllname.dll

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlwapi.h
DLL	Shlwapi.dll (Version 4.71 oder höher)

Share via