Compartilhar via

Função PxeProviderQueryIndex (wdspxe.h)

  • Artigo

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