Функция InstallHinfSectionW (setupapi.h)

[Эта функция доступна для использования в операционных системах, указанных в разделе Требования. В последующих версиях он может быть изменен или недоступен. SetupAPI больше не следует использовать для установки приложений. Вместо этого используйте установщик Windows для разработки установщиков приложений. SetupAPI по-прежнему используется для установки драйверов устройств.]

InstallHinfSection — это функция точки входа, экспортируемая Setupapi.dll, которую можно использовать для выполнения раздела INF-файла. Метод InstallHinfSection можно вызвать, вызвав служебную программу Rundll32.exe, как описано в разделе Примечания.

Прототип функции InstallHinfSection соответствует форме всех функций точек входа, используемых с Rundll32.exe.

При копировании или изменении файла вызывающий объект этой функции должен иметь права на запись в целевой каталог. Если установлены какие-либо службы, вызывающий объект этой функции должен иметь доступ к диспетчеру управления службами.

Синтаксис

void InstallHinfSectionW(
  [in] HWND      Window,
  [in] HINSTANCE ModuleHandle,
  [in] PCWSTR    CommandLine,
  [in] INT       ShowCommand
);

Параметры

[in] Window

Дескриптор родительского окна. Обычно hwnd имеет значение Null.

[in] ModuleHandle

Зарезервировано и должно иметь значение NULL.

[in] CommandLine

Указатель на буфер, содержащий командную строку. Следует использовать строку, завершаемую null.

[in] ShowCommand

Зарезервировано и должно быть равно нулю.

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

None

Remarks

Обратите внимание, что существует три экспорта: InstallHinfSection (для RunDll32), InstallHinfSectionA и InstallHinfSectionW.

Чтобы запустить раздел Install указанного INF-файла, можно вызвать InstallHinfSection с Rundll32.exe, используя следующий синтаксис.

RUNDLL32.EXE SETUPAPI.DLL,путь к> режиму<>раздела<>InstallHinfSection<

В cmdLineBuffer передается путь> режима раздела<<>>.<

Кроме того, программа может вызвать метод InstallHinfSection, InstallHinfSectionA или InstallHinfSectionW напрямую, установив для параметра CmdLineBuffer следующее.

"<section> <mode> <path>"

Где path — это полный путь к INF-файлу, mode — параметр режима перезагрузки, а раздел — любой раздел Install в INF-файле. Разделитель запятых между SETUPAPI.DLL и InstallHinfSection в командной строке является обязательным. Обратите внимание, что между запятой и SETUPAPI.DLL или InstallHinfSection в командной строке не должно быть пробелов.

Рекомендуется указать полный путь к INF-файлу в качестве пути.

Вы можете указать любой раздел Install в INF-файле в качестве раздела. Пробелы в имени не допускаются.

Для параметра mode следует использовать сочетание следующих значений. Необходимо включить значение 128, чтобы установить путь установки по умолчанию в расположение INF, в противном случае предполагается, что inf-файл, предоставленный системой. Добавьте значения, чтобы указать перезагрузку. Обратите внимание, что рекомендуется использовать только значения 128 или 132. Другие значения могут привести к перезагрузке компьютера без необходимости или не перезагрузке при необходимости.

Например, следующая командная строка запускает раздел DefaultInstall файла Shell.inf. Если программа установки определит, что требуется перезагрузка, пользователю будет предложено открыть диалоговое окно "Перезагрузка компьютера, да/нет".

RUNDLL32.EXE SETUPAPI.DLL,InstallHinfSection DefaultInstall 132 C:\WINDOWS\INF\SHELL. INF

Требования