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

另请参阅

PxeProviderRegister

Windows 部署服务服务器函数