PxeRegisterCallback function

Registers callback functions for different notification events.

Syntax


DWORD PXEAPI PxeRegisterCallback(
  _In_  HANDLE hProvider,
  _In_  PXE_CALLBACK_TYPE CallbackType,
  _In_  PVOID pCallbackFunction,
  _In_  PVOID pContext
);

Parameters

hProvider [in]

HANDLE passed to the PxeProviderInitialize function.

CallbackType [in]

Specifies the callback that is being registered.

ValueMeaning
PXE_CALLBACK_RECV_REQUEST
0

Register the PxeProviderRecvRequest callback. This callback must be registered while the provider is processing the PxeProviderInitialize function or the provider will be shut down.

PXE_CALLBACK_SHUTDOWN
1

Register the PxeProviderShutdown callback. This callback must be registered while the provider is processing the PxeProviderInitialize function or the provider will be shut down.

PXE_CALLBACK_SERVICE_CONTROL
2

Register the PxeProviderServiceControl callback.

PXE_CALLBACK_MAX
3

Used to determine an out-of-range index. Values greater than or equal to PXE_CALLBACK_MAX are not valid.

 

pCallbackFunction [in]

Address of the callback function. The function signature varies depending on the CallbackType parameter.

pContext [in]

Context value to be passed to the callback function.

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
PxeProviderInitialize
PxeProviderRecvRequest
PxeProviderServiceControl
PxeProviderShutdown

 

 

Community Additions

ADD
Show:
© 2014 Microsoft