Compartilhar via

Função PxeDhcpv6ParseRelayForw (wdspxe.h)

  • Artigo

Essa função pode ser usada por um provedor para analisar mensagens RELAY-FORW e suas mensagens aninhadas OPTION_RELAY_MSG. As informações retornadas podem ser usadas para construir um pacote RELAY-REPL usando a função PxeDhcpv6CreateRelayRepl .

Para obter mais informações sobre relay-FORW e mensagens de OPTION_RELAY_MSG, 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 PxeDhcpv6ParseRelayForw(
  [in]  PVOID                            pRelayForwPacket,
  [in]  ULONG                            uRelayForwPacketLen,
  [out] PPXE_DHCPV6_NESTED_RELAY_MESSAGE pRelayMessages,
  [in]  ULONG                            nRelayMessages,
  [out] PULONG                           pnRelayMessages,
  [out] PBYTE                            *ppInnerPacket,
  [out] PULONG                           pcbInnerPacket
);

Parâmetros

[in] pRelayForwPacket

Especifica um ponteiro para uma mensagem DHCPv6 RELAY-FORW.

[in] uRelayForwPacketLen

O tamanho em bytes da mensagem RELAY-FORW apontada pelo parâmetro pRelayForwPacket .

[out] pRelayMessages

Uma matriz de estruturas PXE_DHCPV6_NESTED_RELAY_MESSAGE inicializadas por essa rotina. O tamanho da matriz é especificado por nRelayMessages. Elementos dessa matriz são inicializados para apontar para a cadeia aninhada de pacotes de retransmissão codificados em OPTION_RELAY_MSG. O índice 0 é o pacote de OPTION_RELAY_MSG aninhado mais externo. À medida que o índice aumenta, os ponteiros correspondem a pacotes de OPTION_RELAY_MSG mais aninhados.

[in] nRelayMessages

O tamanho da matriz, em número de elementos de matriz, apontado pelo parâmetro pRelayMessages .

[out] pnRelayMessages

Especifica um ponteiro para um valor ULONG que, com êxito, recebe o número real de elementos gravados na matriz pRelayMessages .

[out] ppInnerPacket

Especifica um ponteiro para um valor PVOID que, com êxito, é definido como o início do pacote mais interno na cadeia de retransmissão. Esse é o pacote de solicitação de cliente original.

[out] pcbInnerPacket

Especifica um ponteiro para um valor ULONG que, com êxito, será definido como o tamanho, em bytes, do pacote mais interno na cadeia de retransmissão, que é o pacote de solicitação de cliente original.

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