Функция DllInstall (shlwapi.h)

  • Статья

Обрабатывает установку и настройку библиотеки DLL.

Синтаксис

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

Параметры

bInstall

Тип: BOOL

Значение TRUE , если библиотека DLL устанавливается; False , если он удаляется.

[in, optional] pszCmdLine

Тип: PCWSTR

Строка, передаваемая regsvr32 , указывающая используемую процедуру установки. Это значение может иметь значение NULL.

Возвращаемое значение

Тип: HRESULT

Если эта функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Эта функция может быть реализована и экспортирована по имени библиотекой DLL для использования во время установки или установки приложения. Он вызывается regsvr32 , чтобы разрешить библиотеке DLL выполнять такие задачи, как добавление сведений в реестр.

DllInstall используется только для установки и установки приложений. Он не должен вызываться приложением. По назначению он похож на DllRegisterServer или DllUnregisterServer. В отличие от этих функций, DllInstall принимает входную строку, которую можно использовать для указания различных действий. Это позволяет установить библиотеку DLL несколькими способами на основе любых подходящих условий.

Чтобы использовать DllInstall с regsvr32, добавьте флаг "/i", за которым следует двоеточие (:) и строку. Строка будет передана в DllInstall в качестве параметра pszCmdLine . Если пропустить двоеточие и строку, 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
Header shlwapi.h
DLL Shlwapi.dll (версия 4.71 или более поздняя)