PxeAsyncRecvDone function

Passes the results of processing the client request asynchronously. This function should be called only if the PxeProviderRecvRequest function returns ERROR_IO_PENDING.

Syntax


DWORD PXEAPI PxeAsyncRecvDone(
  _In_ HANDLE          hClientRequest,
  _In_ PXE_BOOT_ACTION Action
);

Parameters

hClientRequest [in]

Handle to the request received from the client.

Action [in]

Specifies the action that the system should take for this client request. The following table lists the possible values.

ValueMeaning
PXE_BA_NBP
1

The provider replied to the client with a standard DHCP response packet that contains the path to the Network Boot Program. Returning this action means that the provider successfully completed the client request by calling the PxeSendReply function at least once.

PXE_BA_CUSTOM
2

The provider replied to the client by using a custom response that does not conform to DHCP specifications. Returning this action means that the provider successfully completed the client request by calling the PxeSendReply function at least once.

PXE_BA_IGNORE
3

The provider does not want to service the client request and the request should not be passed to the next provider. All resources associated with the client request are released and the client request is ignored. Providers can also use this value if they recognize the client but the request was malformed.

PXE_BA_REJECTED
4

The provider does not want to service the client request. The system passes the request to the next provider in the list of registered providers. If this was the last provider in the list, then all resources associated with the client request are released and client request is ignored.

 

Return value

If the function succeeds, the return value is ERROR_SUCCESS.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2008, Windows Server 2003 with SP2 [desktop apps only]

Header

WdsPxe.h

Library

WdsPxe.lib

DLL

WdsPxe.dll

See also

Windows Deployment Services Server Functions
PxeProviderRecvRequest
PxeSendReply

 

 

Community Additions

ADD
Show: