WdsBpParseInitialize function (wdsbp.h)

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

Syntax

DWORD WDSBPAPI WdsBpParseInitialize(
  [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 DHCP 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.

Value	Meaning
WDSBP_PK_TYPE_DHCP 1	The presence of this value indicates that the packet is a DHCP packet.
WDSBP_PK_TYPE_WDSNBP 2	This presence of this value indicates that the DHCP 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.

[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 Vista with SP1 [desktop apps only]
Minimum supported server	Windows Server 2008 [desktop apps only]
Target Platform	Windows
Header	wdsbp.h
Library	Wdsbp.lib
DLL	Wdsbp.dll