Функция PxeProviderRegister (wdspxe.h)
Регистрирует поставщика в системе. Поставщики используют эту функцию во время установки для регистрации в системе. После успешной регистрации возвращается дескриптор раздела реестра, который следует использовать для хранения сведений о конфигурации.
Синтаксис
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
Индекс в списке поставщиков. При необходимости все существующие поставщики смещаются вниз. Администратор может переупорядочить поставщиков по мере необходимости, поэтому не следует делать никаких предположений о порядке работы поставщиков.
| Значение | Значение |
|---|---|
|
Добавьте поставщика в начало списка, чтобы первым получать клиентские запросы. |
|
Добавьте поставщика в конец списка. |
[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 |