Windows Dev Center

WdsBpInitialize function

Constructs options for the WDS network boot program.

Syntax


HRESULT WDSBPAPI WdsBpInitialize(
  _In_  BYTE   bPacketType,
  _Out_ HANDLE *phHandle
);

Parameters

bPacketType [in]

The type of boot program. This parameter may have one of the following values.

ValueMeaning
WDSBP_PK_TYPE_WDSNBP
2

Specify this value to build a boot program using options for the "wdsnbp.com" boot program. The "wdsnbp.com" boot program is the WDS network boot program for IPv4 PXE on legacy BIOS systems and does not support other systems.

WDSBP_PK_TYPE_BCD
4

Specify this value to build a boot program using the WDSBP_OPT_BCD_FILE_PATH option. It may be used with "wdsnbp.com" or other boot programs.

WDSBP_PK_TYPE_DHCPV6
8

Specify this value to indicate that the packet contains a path to a Boot Configuration Data (BCD) file. Use this value for any and all DHCPv6 options. The presence of this value indicates that the packet contains a path to a Boot Configuration Data (BCD) file.

 

phHandle [out]

A pointer to the handle to the packet. This handle can be used by the WdsBpAddOption function to add options for the WDS network boot program. After all the options have been added, use the WdsBpGetOptionBuffer function to add these to the DHCP options list sent to WDS network boot program. The handle must be closed using the WdsBpCloseHandle function.

Return value

If the function succeeds, the return is S_OK.

Requirements

Minimum supported client

Windows Vista with SP1 [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Wdsbp.h

Library

Wdsbp.lib

DLL

Wdsbp.dll

 

 

Community Additions

ADD
Show:
© 2015 Microsoft