Função PxeProviderQueryIndex (wdspxe.h)

Retorna o índice do provedor especificado na lista de provedores registrados.

Sintaxe

DWORD PXEAPI PxeProviderQueryIndex(
  [in]  LPCWSTR pszProviderName,
  [out] PULONG  puIndex
);

Parâmetros

[in] pszProviderName

Nome amigável para o provedor da chamada para a função PxeProviderRegister .

[out] puIndex

Endereço de um ULONG que receberá o índice do provedor.

Retornar valor

Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS.

Comentários

Se um provedor quiser se inserir na lista de provedores registrados em uma ordem específica (ou seja, deseja atender solicitações de cliente antes ou depois de um determinado provedor), ele pode consultar o índice de outro provedor e, em seguida, usar o índice retornado para decidir sua própria localização.

Exemplos

//
// 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
 }
}

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2008, Windows Server 2003 com SP2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wdspxe.h
Biblioteca	WdsPxe.lib
DLL	WdsPxe.dll

Confira também

PxeProviderRegister

Funções do Servidor dos Serviços de Implantação do Windows