共用方式為

DllInstall 函式 (shlwapi.h)

  • 發行項

處理 DLL 的安裝和設定。

語法

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

參數

bInstall

類型： BOOL

如果已安裝 DLL，則為 TRUE;如果正在卸載，則為 FALSE。

[in, optional] pszCmdLine

類型： PCWSTR

regsvr32 傳入的字串，指出要使用的設定程式。 此值可以是 NULL。

傳回值

類型： HRESULT

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

此函式可由 DLL 實作和匯出，以供應用程式安裝或安裝期間使用。 regsvr32 會叫用它，以允許 DLL 執行工作，例如將資訊新增至登錄。

DllInstall 僅用於應用程式安裝和設定。 應用程式不應該呼叫它。 其用途類似於 DllRegisterServer 或 DllUnregisterServer。 不同於這些函式， DllInstall 會採用可用來指定各種不同動作的輸入字串。 這可讓您根據任何適當的準則，以一種以上的方式安裝 DLL。

若要搭配 regsvr32 使用 DllInstall，請新增 “/i” 旗標，後面接著冒號 (：) 和字串。 字串會以 pszCmdLine 參數的形式傳遞至 DllInstall。 如果您省略冒號和字串， pszCmdLine 將會設定為 NULL。 下列範例會用來安裝 DLL。

regsvr32 /i：“Install_1” dllname.dll

DllInstall 會在 bInstall 設定為 TRUE 且 pszCmdLine 設定為 “Install_1” 時叫用。 若要卸載 DLL，請使用下列專案：

regsvr32 /u /i：“Install_1” dllname.dll

使用上述這兩個範例時，也會呼叫 DllRegisterServer 或 DllUnregisterServer 。 若要只呼叫 DllInstall ，請新增 “/n” 旗標。

regsvr32 /n /i：“Install_1” dllname.dll

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional、Windows XP [僅限桌面應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 shlwapi.h
Dll Shlwapi.dll (4.71 版或更新版本)