Edit

Share via

WdsBpParseInitializev6 function (wdsbp.h)

  • Article

Receives a handle to the packet sent by the network boot program.

Syntax

DWORD WDSBPAPI WdsBpParseInitializev6(
  [in]            PVOID  pPacket,
  [in]            ULONG  uPacketLen,
  [out, optional] PBYTE  pbPacketType,
  [out]           HANDLE *phHandle
);

Parameters

[in] pPacket

A pointer to the packet received from the WDS client. The packet must be a valid DHCPv6 packet.

[in] uPacketLen

The length of the packet, in bytes.

[out, optional] pbPacketType

A value that indicates the type of boot program that sent the packet. The bit flags in the following table can be combined except WDSBP_PK_TYPE_DHCP and WDSBP_PK_TYPE_DHCPV6 are mutually exclusive.

Value Meaning
WDSBP_PK_TYPE_DHCP
1
 The presence of this value indicates that the packet is a DHCP packet. This value is mutually exclusive of WDSBP_PK_TYPE_DHCPV6.
WDSBP_PK_TYPE_WDSNBP
2
 This presence of this value indicates that the DHCPv6 packet came from the WDS network boot program. If this value is absent the type of client was not recognized.
WDSBP_PK_TYPE_BCD
4
 The presence of this value indicates that the packet contains a path to a Boot Configuration Data (BCD) file.
WDSBP_PK_TYPE_DHCPV6
8
 The presence of this value indicates that the packet is a DHCPV6 packet. This value is mutually exclusive of WDSBP_PK_TYPE_DHCP.

[out] phHandle

A handle to the packet. This handle can be used by the WdsBpQueryOption function and must be closed using the WdsBpCloseHandle function.

Return value

If the function succeeds, the return is S_OK.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Target Platform Windows
Header wdsbp.h
Library Wdsbp.lib
DLL Wdsbp.dll