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。

若要将 DllInstall 与 regsvr32 配合使用，请添加一个“/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 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	shlwapi.h
DLL	Shlwapi.dll (4.71 或更高版本)