Main Page | Modules | Data Structures | Data Fields

Subscribe Operation
[RendezvousService Client Bindings]

Typedefs

Functions

Detailed Description

The functions and types in this group are used by clients which will be making Subscribe requests of the RendezvousService service.

For clients which want blocking SOAP calls, the functions RendezvousPortType_Subscribe() and RendezvousPortType_Subscribe_epr() will be most appropriate. For clients which want nonblocking SOAP calls, RendezvousPortType_Subscribe_register() and RendezvousPortType_Subscribe_epr_register() will be most appropriate.

The other functions in this section are used by applications which require more control over the operation invocation by having separate invocations and callbacks for the request and response handling of the operation.

Typedef Documentation

typedef void(* RendezvousPortType_Subscribe_request_callback_func_t)(
     RendezvousService_client_handle_t handle
     void * user_args
     globus_result_t result)
 

Request callback function.

Use a function of this type when calling one of the nonblocking request functions for the Subscribe operation.

When the request has been sent to the service, this callback function will be called. If the result is GLOBUS_SUCCESS, then the application must then call one of the response functions with the same handle to receive the response to this operation.

Parameters:
handle The client handle used for the operation invocation.
user_args Application specific pointer, passed to the operation's register function.
result The result of operation request.

typedef void(* RendezvousPortType_Subscribe_response_callback_func_t)(
     RendezvousService_client_handle_t handle
     void * user_args
     globus_result_t result
     const wsnt_SubscribeResponseType * SubscribeResponse
     RendezvousPortType_Subscribe_fault_t fault_type
     const xsd_any * fault)
 

Response callback function.

Use a function of this type when calling one of the nonblocking operation or response functions for the Subscribe operation.

When the response has been received from the service, this callback function will be called.

Parameters:
handle The client handle used for the operation invocation.
user_args Application specific pointer, passed to the operation's register function.
result The result of operation request.
SubscribeResponse The output of the operation, if the operation succeeded.
fault_type The type of fault sent as a result of the operation, if the operation failed. If the operation succeeded, this will be NULL.
fault The fault element which was received, if the operation failed. If the operation succeeded, this will be NULL.

Function Documentation

globus_result_t RendezvousPortType_Subscribe_epr_register_request (
     RendezvousService_client_handle_t handle,
     const wsa_EndpointReferenceType * epr,
     const wsnt_SubscribeType * Subscribe,
     RendezvousPortType_Subscribe_request_callback_func_t callback,
     void * user_args)
 

Nonblocking operation request with EPR.

Begin sending a request for the Subscribe operation on a resource handled by the service named by the epr. When the operation request has been sent, the callback function will be invoked.

Parameters:
handle The client handle which contains the state related to processing this operation.
epr Endpoint Reference of the service and resource which will process the operation.
Subscribe Input parameter to the operation.
callback Callback function which will be called once the request has been sent
user_args Application-specific pointer which will be passed to the callback.

globus_result_t RendezvousPortType_Subscribe_register_request (
     RendezvousService_client_handle_t handle,
     const char * endpoint,
     const wsnt_SubscribeType * Subscribe,
     RendezvousPortType_Subscribe_request_callback_func_t callback,
     void * user_args)
 

Nonblocking operation request.

Begin sending a request for the Subscribe operation to the service at endpoint. When the operation request has been sent, the callback function will be invoked.

Parameters:
handle The client handle which contains the state related to processing this operation.
endpoint URI of the service endpoint to send the request to.
Subscribe Input parameter to the operation.
callback Callback function which will be called once the request has been sent
user_args Application-specific pointer which will be passed to the callback.

globus_result_t RendezvousPortType_Subscribe_register_response (
     RendezvousService_client_handle_t handle,
     RendezvousPortType_Subscribe_response_callback_func_t callback,
     void * user_args)
 

Nonblocking operation response handling.

Begin parsing the request for the Subscribe operation begun by an earlier call to RendezvousPortType_Subscribe_register_request() or RendezvousPortType_Subscribe_epr_register_request(). Once the response has been parsed. the callback function will be called to pass the result of the operation to the application.

Parameters:
handle The client handle which contains the state related to processing this operation.
callback Callback function which will be called once the response has been processed.
user_args Application-specific pointer which will be passed to the callback.

globus_result_t RendezvousPortType_Subscribe_epr_register (
     RendezvousService_client_handle_t handle,
     const wsa_EndpointReferenceType * epr,
     const wsnt_SubscribeType * Subscribe,
     RendezvousPortType_Subscribe_response_callback_func_t callback,
     void * user_args)
 

Nonblocking operation invocation with EPR.

Begin processing a request for the Subscribe operation. The operation will sent to the service named by the epr and after the response is received, the callback function will be invoked.

Parameters:
handle The client handle which contains the state related to processing this operation.
epr Endpoint Reference of the service and resource which will process the operation.
Subscribe Input parameter to the operation.
callback Callback function which will be called once the operation has been processed.
user_args Application-specific pointer which will be passed to the callback.

globus_result_t RendezvousPortType_Subscribe_register (
     RendezvousService_client_handle_t handle,
     const char * endpoint,
     const wsnt_SubscribeType * Subscribe,
     RendezvousPortType_Subscribe_response_callback_func_t callback,
     void * user_args)
 

Nonblocking operation invocation.

Begin processing a request for the Subscribe operation. The operation will sent to the service located at endpoint and after the response is received, the callback function will be invoked.

Parameters:
handle The client handle which contains the state related to processing this operation.
endpoint URI of the service endpoint to send the request to.
Subscribe Input parameter to the operation.
callback Callback function which will be called once the operation has been processed.
user_args Application-specific pointer which will be passed to the callback.

globus_result_t RendezvousPortType_Subscribe_epr (
     RendezvousService_client_handle_t handle,
     const wsa_EndpointReferenceType * epr,
     const wsnt_SubscribeType * Subscribe,
     wsnt_SubscribeResponseType ** SubscribeResponse,
     RendezvousPortType_Subscribe_fault_t * fault_type,
     xsd_any ** fault)
 

Blocking operation invocation with EPR.

Request that an the Subscribe operation be invoked by the service and resource named by the epr parameter.

If the result is GLOBUS_SUCCESS, then the SubscribeResponse parameter will be set to the result of the operation. Otherwise, if the fault and fault_type parameters are non-NULL, they indicate the SOAP fault type. If they are NULL, then some non-SOAP error occurred, and the result's error type should be checked.

Parameters:
handle The client handle which contains the state related to processing this operation.
epr Endpoint Reference of the service and resource which will process the operation.
Subscribe Input parameter to the operation.
SubscribeResponse The output of the operation, if the operation succeeded.
fault_type The type of fault sent as a result of the operation, if the operation failed. If the operation succeeded, this will be NULL.
fault The fault element which was received, if the operation failed. If the operation succeeded, this will be NULL.

globus_result_t RendezvousPortType_Subscribe (
     RendezvousService_client_handle_t handle,
     const char * endpoint,
     const wsnt_SubscribeType * Subscribe,
     wsnt_SubscribeResponseType ** SubscribeResponse,
     RendezvousPortType_Subscribe_fault_t * fault_type,
     xsd_any ** fault)
 

Blocking operation invocation.

Request that an the Subscribe operation be invoked by the service at endpoint.

If the result is GLOBUS_SUCCESS, then the SubscribeResponse parameter will be set to the result of the operation. Otherwise, if the fault and fault_type parameters are non-NULL, they indicate the SOAP fault type. If they are NULL, then some non-SOAP error occurred, and the result's error type should be checked.

Parameters:
handle The client handle which contains the state related to processing this operation.
endpoint URI of the service endpoint to send the request to.
Subscribe Input parameter to the operation.
SubscribeResponse The output of the operation, if the operation succeeded.
fault_type The type of fault sent as a result of the operation, if the operation failed. If the operation succeeded, this will be NULL.
fault The fault element which was received, if the operation failed. If the operation succeeded, this will be NULL.

about globus | grid research | globus toolkit | software development

Comments? webmaster@globus.org