Функция PxeProviderRegister (wdspxe.h)

Статья
08/27/2023

Регистрирует поставщика в системе. Поставщики используют эту функцию во время установки для регистрации в системе. После успешной регистрации возвращается дескриптор раздела реестра, который следует использовать для хранения сведений о конфигурации.

Синтаксис

DWORD PXEAPI PxeProviderRegister(
  [in]  LPCWSTR       pszProviderName,
  [in]  LPCWSTR       pszModulePath,
  [in]  PXE_REG_INDEX Index,
  [in]  BOOL          bIsCritical,
  [out] PHKEY         phProviderKey
);

Параметры

[in] pszProviderName

Адрес строки, заканчивающейся null, которая указывает отображаемое имя поставщика. Это имя отображается для пользователя и должно быть уникальным среди зарегистрированных поставщиков.

[in] pszModulePath

Адрес строки, завершающейся значением NULL, которая указывает полный путь к библиотеке DLL поставщика.

[in] Index

Индекс в списке поставщиков. При необходимости все существующие поставщики смещаются вниз. Администратор может переупорядочить поставщиков по мере необходимости, поэтому не следует делать никаких предположений о порядке работы поставщиков.

Значение	Значение
PXE_REG_INDEX_TOP 0	Добавьте поставщика в начало списка, чтобы первым получать клиентские запросы.
PXE_REG_INDEX_BOTTOM 0xFFFFFFFF	Добавьте поставщика в конец списка.

[in] bIsCritical

Указывает, является ли поставщик критическим. Если критически важный поставщик завершается сбоем, произойдет также сбой сервера WDS.

[out] phProviderKey

Адрес ключа HKEY , в котором должна храниться конфигурация. Поставщик получит дескриптор того же ключа, что и параметр hProviderKey для обратного вызова PxeProviderInitialize .

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

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

Требования

Требование	Значение
Минимальная версия клиента	Ни одна версия не поддерживается
Минимальная версия сервера	Windows Server 2008, Windows Server 2003 с пакетом обновления 2 (SP2) [только классические приложения]
Целевая платформа	Windows
Header	wdspxe.h
Библиотека	WdsPxe.lib
DLL	WdsPxe.dll

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

PxeProviderInitialize

PxeProviderUnRegister

Функции сервера служб развертывания Windows

Поделиться через