Директива INF RegisterDlls

  • Статья

Внимание!

Начиная с Windows 11 версии 22H2, пакет драйвера, использующий эту директиву, больше не может быть подписан центром разработчиков оборудования.

Пакеты универсальных драйверов и драйверы Windows не могут использовать эту директиву.

Примечание

С помощью средства Reg2inf можно преобразовать существующие директивы INF RegisterDlls в директивы INF AddReg , чтобы сделать пакет драйвера универсальным.

Директива RegisterDlls ссылается на один или несколько разделов INF, используемых для указания файлов, которые являются элементами управления OLE и требуют самостоятельной регистрации.

[DDInstall]
  
RegisterDlls=register-dll-section[,register-dll-section]...

Каждый раздел INF, на который ссылается директива RegisterDlls , должен иметь следующий формат записи:

[register-dll-section] 
  
dirid,[subdir],filename,registration-flags[,[timeout][,argument]]

Раздел register-dll-section может содержать любое количество записей, каждая из которых размещена в отдельной строке.

Записи

dirid
Указывает идентификатор каталога назначения регистраемого файла. Дополнительные сведения см. в разделе Использование dirids.

вложенный каталог
Указывает путь к региструемого файла относительно текущего каталога. Если значение не указано, файл находится в текущем каталоге.

filename
Определяет имя файла зарегистрированного элемента управления OLE.

флаги регистрации
Указывает операции регистрации, выполняемые с элементом управления OLE. Необходимо указать один или оба следующих флага.

0x00000001 (FLG_REGSVR_DLLREGISTER)
Вызовите функцию DllRegisterServer элемента управления OLE (описанную в документации по Windows SDK).

0x00000002 (FLG_REGSVR_DLLINSTALL)
Вызовите функцию DllInstall элемента управления OLE (описанную в документации по Windows SDK).

timeout
Указывает время ожидания (в единицах секунд) для ole Control для выполнения указанных вызовов регистрации. Время ожидания по умолчанию составляет 60 секунд.

argument
Если элемент управления является исполняемым файлом, это командная строка, которая передается исполняемому файлу. Аргумент по умолчанию — /RegServer.

Если элемент управления не является исполняемым файлом, он указывает аргумент командной строки для передачи функции DllInstall .

Комментарии

Каждое имя register-dll-section должно быть уникальным для INF-файла и соответствовать общим правилам определения имен разделов. Дополнительные сведения об этих правилах см. в разделе Общие правила синтаксиса для ФАЙЛОВ INF.

Следующие правила применяются к использованию директивы RegisterDlls для установки устройств.

  • Хотя синтаксис допускает, что имя файла может быть dll или исполняемым файлом, для установки устройств допускается только библиотека DLL.

  • Регистримый код не должен запрашивать ввод данных пользователем.

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

Дополнительные сведения об элементах управления OLE и самостоятельной регистрации см. в документации windows SDK.

Примеры

[Dialer]
RegisterDlls = DialerRegSvr

[DialerUninstall]
UnregisterDlls = DialerRegSvr

[DialerRegSvr]
11,,avtapi.dll, 1

См. также раздел

Отмена регистрацииDlls