Funzione DllInstall (shlwapi.h)

Articolo
08/26/2023

Gestisce l'installazione e la configurazione per una DLL.

Sintassi

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

Parametri

bInstall

Tipo: BOOL

TRUE se la DLL è in corso di installazione; FALSE se viene disinstallato.

[in, optional] pszCmdLine

Tipo: PCWSTR

Stringa passata da regsvr32 che indica quale procedura di installazione usare. Questo valore può essere NULL.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questa funzione può essere implementata ed esportata in base al nome di una DLL da usare durante l'installazione o l'installazione dell'applicazione. Viene richiamato da regsvr32 per consentire alla DLL di eseguire attività come l'aggiunta di informazioni al Registro di sistema.

DllInstall viene usato solo per l'installazione e la configurazione dell'applicazione. Non deve essere chiamato da un'applicazione. È simile allo scopo di DllRegisterServer o DllUnregisterServer. A differenza di queste funzioni, DllInstall accetta una stringa di input che può essere usata per specificare un'ampia gamma di azioni diverse. Ciò consente l'installazione di una DLL in più modi, in base a qualsiasi criterio appropriato.

Per usare DllInstall con regsvr32, aggiungere un flag "/i" seguito da due punti (:) e una stringa. La stringa verrà passata a DllInstall come parametro pszCmdLine . Se si omette i due punti e la stringa, pszCmdLine verrà impostato su NULL. L'esempio seguente verrà usato per installare una DLL.

dllname.dllregsvr32 /i:"Install_1"

DllInstall viene richiamato con bInstall impostato su TRUE e pszCmdLine impostato su "Install_1". Per disinstallare una DLL, usare quanto segue:

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

Con entrambi gli esempi precedenti, verrà chiamato anche DllRegisterServer o DllUnregisterServer. Per chiamare solo DllInstall , aggiungere un flag "/n".

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlwapi.h
DLL	Shlwapi.dll (versione 4.71 o successiva)