NAME

GRPC_CANCEL_ALL - Cancels all sessions.

SYNOPSIS

INTEGER FUNCTION GRPC_CANCEL_ALL()

ARGUMENTS

None

DESCRIPTION

The GRPC_CANCEL_ALL() function cancels all of the executing sessions.

GRPC_CANCEL_ALL() is a non-blocking function. It does not wait for the completion of the cancellation.

A cancelled session should be taken care by a wait function such as GRPC_WAIT() so that the allocated resources for the session can be released.

Wait functions such as GRPC_WAIT() return GRPC_SESSION_FAILED if those functions detect the cancelled session. GRPC_GET_ERROR(SID) returns GRPC_CANCELED_NP if the cancel was successfully completed. Otherwise, it returns an error.

This function is MT-safe.

RETURN VALUE

If successful, GRPC_NO_ERROR is returned. In the case of an error, Error code is returned.

ERRORS

GRPC_NOT_INITIALIZED
GRPC client is not initialized yet.
GRPC_OTHER_ERROR_CODE
Internal error detected.

last update : $Date$