2.2 Message Syntax

The WDS OS Deployment Protocol MUST support the following opcodes under the OS deployment Endpoint GUID.

Opcode

Authentication requirements

Description

WDS_OP_IMG_ENUMERATE

0x00000002

Authenticated

Enumerate and return the list of OS images available to client machine. See section 2.2.6.

WDS_OP_LOG_INIT

0x00000003

Authenticated and Unauthenticated

Provides a unique Transaction ID and severity level for status messages that MUST be logged by the client. See section 2.2.1.

WDS_OP_LOG_MSG

0x00000004

Authenticated and Unauthenticated

Logs a status message on the server, specifying status update from client. See section 2.2.2.

WDS_OP_GET_CLIENT_UNATTEND

0x00000005

Authenticated and Unauthenticated

Queries the server for deployment agent unattend. See section 2.2.3.

WDS_OP_GET_UNATTEND_VARIABLES

0x00000006

Authenticated

Queries the server for values for variables to be consumed for deployed OS Unattend. See section 2.2.4.

WDS_OP_GET_DOMAIN_JOIN_INFORMATION

0x00000007

Authenticated

Queries the server to find out if the client SHOULD join a domain, and the details of the domain to be joined. See section 2.2.5.

WDS_OP_RESET_BOOT_PROGRAM

0x00000008

Authenticated

Sent by the client to notify the server that the deployment is complete and therefore the server SHOULD reset the PXE boot program selected for the client if appropriate per server policy. Thus, the client will not attempt to boot from the network after the client next reboots. For more details about the booting process, see section 2.2.10.

The WDS OS Deployment Protocol MAY<1> support the dynamic driver provisioning Endpoint GUID. If supported, the dynamic driver provisioning Endpoint GUID MUST support the following opcodes.

Opcode

Authentication requirements

Description

DDP_OP_GET_MACHINE_DRIVER_PACKAGES

0x000000C8

Authenticated

Queries the server for driver packages that match the devices that are installed on the client machines.

The WDS OS Deployment Protocol MAY<2> support the deployment agent metadata Endpoint GUID. If supported, the deployment agent metadata Endpoint GUID MUST support the following opcodes.

Opcode

Authentication requirements

Description

WDSDCMGR_OP_QUERY_METADATA

0x00000002

Authenticated or Unauthenticated

Queries the server for deployment agent metadata.