a0TestRequest()

Verifies if a request is complete.


Syntax

a0tError a0TestRequest(
a0tRequest *request,
int *result );

Arguments

Namerd/wrDescription
request write Request to test on and hold the status.
result write Result of the test.

Description

This function verifies if a previous request has already completed. It doesn't block the calling thread, but verifies if the request specified in request is completed. In the case of positive completion of the request it can't be waited or tested anymore.

It returns in result the values TRUE or FALSE, whether the request has completed or not. In the positive case, it also inserts in the request structure its final status (see a0GetRequestData()).


Return Values

If an error condition occurs, it returns the error code, otherwise it returns A0ErrOk. Possible values are as follows:
Error CodeDescription
A0ErrNullReq The request is NULL.
A0Err...Some error occurred.
A0ErrOkSuccessful completion.

See Also

a0TestAnyRequest() a0WaitRequest() a0ISend() a0IReceive() a0ISendBuffer() a0IReceiveBuffer()