NAME

grpc_cancel_all - Cancels all sessions.

SYNOPSIS

grpc_error_t 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(sessionID) 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: 2005/07/11 07:11:24 $