共用方式為

PxeDhcpv6ParseRelayForw 函式 (wdspxe.h)

  • 發行項

提供者可以使用此函式來剖析 RELAY-FORW 訊息及其巢狀OPTION_RELAY_MSG訊息。 傳回的資訊可用來使用 PxeDhcpv6CreateRelayRepl 函式來建構 RELAY-REPL 封包。

如需 RELAY-FORW 和OPTION_RELAY_MSG訊息的詳細資訊，開發人員應該參考 Internet Engineering Task Force (IETF) 維護的 IPv6 (RFC 331) 5 動態主機組態通訊協定。

語法

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
);

參數

[in] pRelayForwPacket

指定 DHCPv6 RELAY-FORW 訊息的指標。

[in] uRelayForwPacketLen

pRelayForwPacket 參數所指向的 RELAY-FORW 訊息位元組大小。

[out] pRelayMessages

這個例程所初始化 之PXE_DHCPV6_NESTED_RELAY_MESSAGE 結構的陣列。 陣列的大小是由 nRelayMessages 指定。 此陣列元素會初始化為指向以OPTION_RELAY_MSG編碼之轉寄封包的巢狀鏈結。 索引 0 是最外層的巢狀OPTION_RELAY_MSG封包。 當索引增加指標時，指標會對應至更深入的巢狀OPTION_RELAY_MSG封包。

[in] nRelayMessages

陣列的大小，以陣列元素數目為單位，由 pRelayMessages 參數所指向。

[out] pnRelayMessages

指定 ULONG 值的指標，該值在成功時會接收寫入 pRelayMessages 陣列的實際項目數目。

[out] ppInnerPacket

指定 PVOID 值的指標，此值在成功時會設定為轉寄鏈結中最內部封包的開頭。 這是原始用戶端要求封包。

[out] pcbInnerPacket

指定 ULONG 值的指標，其成功時會設定為原始用戶端要求封包之轉寄鏈結中最內部封包的大小，以位元組為單位。

傳回值

如果函式成功，傳回值 會ERROR_SUCCESS。

規格需求

需求 值
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
目標平台 Windows
標頭 wdspxe.h
程式庫 WdsPxe.lib
Dll WdsPxe.dll