通过

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

索引到提供程序列表中。 如有必要，任何现有提供程序都将被下移。 管理员可以根据需要重新排列提供程序，因此不应对提供程序的顺序做出假设。

值 含义
PXE_REG_INDEX_TOP
0
 将提供程序添加到列表顶部，成为第一个接收客户端请求的提供程序。
PXE_REG_INDEX_BOTTOM
0xFFFFFFFF
 将提供程序添加到列表底部。

[in] bIsCritical

指示提供程序是否重要。 如果关键提供程序失败，WDS 服务器也将失败。

[out] phProviderKey

应存储配置的 HKEY 的地址。 提供程序将收到此密钥的句柄，该句柄与其 PxeProviderInitialize 回调的 hProviderKey 参数相同。

返回值

如果函数成功，则返回值 ERROR_SUCCESS。

要求

要求 值
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2008、Windows Server 2003 SP2 [仅限桌面应用]
目标平台 Windows
标头 wdspxe.h
Library WdsPxe.lib
DLL WdsPxe.dll

另请参阅

PxeProviderInitialize

PxeProviderUnRegister

Windows 部署服务服务器函数