PxeProviderQueryIndex 函数 (wdspxe.h)
返回已注册提供程序列表中指定提供程序的索引。
语法
DWORD PXEAPI PxeProviderQueryIndex(
[in] LPCWSTR pszProviderName,
[out] PULONG puIndex
);
参数
[in] pszProviderName
调用 PxeProviderRegister 函数时提供程序的友好名称。
[out] puIndex
将接收提供程序索引的 ULONG 的地址。
返回值
如果函数成功,则返回值 ERROR_SUCCESS。
注解
如果提供程序希望按特定顺序插入已注册提供程序列表中, (即,要在某个提供程序) 之前或之后为客户端请求提供服务,则可以查询另一个提供程序的索引,然后使用返回的索引来确定其自己的位置。
示例
//
// Suppose Provider wants to handle requests after BINLSVC has rejected them.
//
dwError = PxeProviderQueryIndex(L"BINLSVC", &Index);
if (dwError == ERROR_SUCCESS)
{
if (PxeProviderRegister(L"MYPROV",
L"C:\\MyDir\\MyProv.DLL",
PXE_REG_INDEX_BOTTOM,
Index + 1, // Add after BINLSVC
&hKey) != ERROR_SUCCESS)
{
// Handle Error
}
}
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 无受支持的版本 |
最低受支持的服务器 | Windows Server 2008、Windows Server 2003 SP2 [仅限桌面应用] |
目标平台 | Windows |
标头 | wdspxe.h |
Library | WdsPxe.lib |
DLL | WdsPxe.dll |