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 的地址。 提供程序将收到此密钥的句柄,该句柄与其 PxeProviderInitialize 回调的 hProviderKey 参数相同。
返回值
如果函数成功,则返回值 ERROR_SUCCESS。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 无受支持的版本 |
最低受支持的服务器 | Windows Server 2008、Windows Server 2003 SP2 [仅限桌面应用] |
目标平台 | Windows |
标头 | wdspxe.h |
Library | WdsPxe.lib |
DLL | WdsPxe.dll |