通过

PxeDhcpv6ParseRelayForw 函数 (wdspxe.h)

  • 项目

提供程序可以使用此函数来分析 RELAY-FORW 消息及其嵌套OPTION_RELAY_MSG消息。 返回的信息可用于使用 PxeDhcpv6CreateRelayRepl 函数构造 RELAY-REPL 数据包。

有关 RELAY-FORW 和OPTION_RELAY_MSG消息的详细信息，开发人员应参考由 Internet 工程任务组 (IETF) 维护的 IPv6 (RFC 3315) 动态主机配置协议。

语法

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
Library WdsPxe.lib
DLL WdsPxe.dll