NAME

grpc_get_handle - Gets a function handle.

SYNOPSIS

grpc_error_t grpc_get_handle(grpc_function_handle_t **handle, grpc_sessionid_t session_id)

ARGUMENTS

grpc_function_handle_t **handle
The function handle
grpc_sessionid_t session_id
The session ID

DESCRIPTION

The grpc_get_handle() function returns a function handle for the session specified by the session ID.

If the value specified in session_id is ID of session of Object Handle, this API returns error.

In Ninf-G, there are grpc_function_handle_get_from_session_np() which gets a function handle, and grpc_object_handle_get_from_session_np() which gets an object handle.

The function of grpc_get_handle() and grpc_function_handle_get_from_session_np() is the same.

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_INVALID_SESSION_ID
Session ID is not valid.
GRPC_OTHER_ERROR_CODE
Internal error detected.

last update : $Date: 2005/07/11 07:11:24 $