PsRequestGetStatus

Returns the status of the request.

Syntax

PULSE_STATUS PsRequestGetStatus(
 [in] PPS_REQUEST pRequest
);

Parameters

PPS_REQUEST pRequest

An opaque handle to a request created by the PsRequestCreate function.

Return value

If the underlying Pulse API call succeeds, the return value is PULSE_STATUS_SUCCESS.

If it fails, it returns one of the PULSE_STATUS values. Possible return codes include, but are not limited to, the following:

PULSE_STATUS_REQUEST_NOT_INITIALIZED
0xC0000402
No Pulse API function has been assigned to the request.

Remarks

This function returns the status of the request and depends on the Pulse API call result. It would be incorrect to document the return value of the function here since it does not make sense without a request context.

After a successful request completion, use either the PsRequestReset function to recycle the request for another Pulse API call or the PsRequestDestroy function to destroy the request handle and free its resources.

Warning! This function does not check if the pRequest parameter is NULL!