Função PxeGetServerInfoEx (wdspxe.h)

Artigo
03/03/2024

Retorna informações sobre o servidor PXE.

Para obter mais informações sobre a opção OPTION_SERVERID, os desenvolvedores devem consultar o Protocolo de Configuração de Host Dinâmico para IPv6 (RFC 3315) mantido pelo IETF (Internet Engineering Task Force).

Sintaxe

DWORD PXEAPI PxeGetServerInfoEx(
  [in]  PXE_GSI_TYPE uInfoType,
  [out] PVOID        pBuffer,
  [in]  ULONG        uBufferLen,
  [out] PULONG       puBufferUsed
);

Parâmetros

[in] uInfoType

Seleciona as informações que serão retornadas.

Valor	Significado
PXE_GSI_TRACE_ENABLED 1	Retorna um BOOL que indica se o rastreamento está habilitado para o servidor. TRUE indica que o rastreamento está habilitado.
PXE_GSI_SERVER_DUID 2	Retorna uma matriz de bytes que corresponde ao DUID DHCPv6 que é enviado para clientes PXE DHCPv6 em pacotes de resposta na opção OPTION_SERVERID. PXE_GSI_SERVER_DUID não pode ser usado com PxeGetServerInfo.

[out] pBuffer

Endereço de um buffer que receberá os resultados da consulta. O tamanho e o formato dos resultados dependem do valor do parâmetro uInfoType .

[in] uBufferLen

Tamanho do buffer apontado pelo parâmetro pBuffer .

[out] puBufferUsed

Tamanho do buffer apontado pelo parâmetro pBuffer .

Retornar valor

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wdspxe.h
Biblioteca	WdsPxe.lib
DLL	WdsPxe.dll

Confira também

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

Compartilhar via