Subscribe Operation
[RendezvousService Client Bindings]

Collaboration diagram for Subscribe Operation:
The functions and types in this group are used by clients which will be making Subscribe requests of the RendezvousService service. More...

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 *callback_arg, 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.
callback_arg 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 *callback_arg, globus_result_t result, const wsnt_SubscribeResponseType *output, 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.
callback_arg Application specific pointer, passed to the operation's register function.
result The result of operation request.
output 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  client_handle,
const wsa_EndpointReferenceType *  epr,
const wsnt_SubscribeType *  input,
RendezvousPortType_Subscribe_request_callback_func_t  callback,
void *  callback_arg 
)

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:
client_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.
input Input parameter to the operation.
callback Callback function which will be called once the request has been sent
callback_arg Application-specific pointer which will be passed to the callback.

globus_result_t RendezvousPortType_Subscribe_register_request ( RendezvousService_client_handle_t  client_handle,
const char *  endpoint,
const wsnt_SubscribeType *  input,
RendezvousPortType_Subscribe_request_callback_func_t  callback,
void *  callback_arg 
)

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.
input Input parameter to the operation.
callback Callback function which will be called once the request has been sent
callback_arg Application-specific pointer which will be passed to the callback.

globus_result_t RendezvousPortType_Subscribe_register_response ( RendezvousService_client_handle_t  client_handle,
RendezvousPortType_Subscribe_response_callback_func_t  callback,
void *  callback_arg 
)

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:
client_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.
callback_arg 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 *  input,
RendezvousPortType_Subscribe_response_callback_func_t  callback,
void *  callback_arg 
)

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.
input Input parameter to the operation.
callback Callback function which will be called once the operation has been processed.
callback_arg 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 *  input,
RendezvousPortType_Subscribe_response_callback_func_t  callback,
void *  callback_arg 
)

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.
input Input parameter to the operation.
callback Callback function which will be called once the operation has been processed.
callback_arg 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 *  input,
wsnt_SubscribeResponseType **  output,
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 output 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.
input Input parameter to the operation.
output 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 *  input,
wsnt_SubscribeResponseType **  output,
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 output 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.
input Input parameter to the operation.
output 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