Error Data Accessors and Modifiers
Collaboration diagram for Error Data Accessors and Modifiers:

Get Source

Set Source

Get Cause

Set Cause

Get Type

Set Type

Get Short Description

Set Short Description

Get Long Description

Set Long Description


Detailed Description

Get and set data in a Globus Generic Error object.

This section defines operations for accessing and modifying data in a Globus Generic Error object.


Function Documentation

globus_module_descriptor_t* globus_error_get_source ( globus_object_t *  error)

Retrieve the originating module descriptor from a error object.

Parameters:
errorThe error from which to retrieve the module descriptor
Returns:
The originating module descriptor.
void globus_error_set_source ( globus_object_t *  error,
globus_module_descriptor_t *  source_module 
)

Set the originating module descriptor in a error object.

Parameters:
errorThe error object for which to set the causative error
source_moduleThe originating module descriptor
Returns:
void
globus_object_t* globus_error_get_cause ( globus_object_t *  error)

Retrieve the underlying error from a error object.

Parameters:
errorThe error from which to retrieve the causative error.
Returns:
The underlying error object if it exists, NULL if it doesn't.
void globus_error_set_cause ( globus_object_t *  error,
globus_object_t *  causal_error 
)

Set the causative error in a error object.

Parameters:
errorThe error object for which to set the causative error.
causal_errorThe causative error.
Returns:
void
int globus_error_get_type ( globus_object_t *  error)

Retrieve the error type from a generic globus error object.

Parameters:
errorThe error from which to retrieve the error type
Returns:
The error type of the object
void globus_error_set_type ( globus_object_t *  error,
const int  type 
)

Set the error type in a generic globus error object.

Parameters:
errorThe error object for which to set the error type
typeThe error type
Returns:
void
char* globus_error_get_short_desc ( globus_object_t *  error)

Retrieve the short error description from a generic globus error object.

Parameters:
errorThe error from which to retrieve the description
Returns:
The short error description of the object
void globus_error_set_short_desc ( globus_object_t *  error,
const char *  short_desc_format,
  ... 
)

Set the short error description in a generic globus error object.

Parameters:
errorThe error object for which to set the description
short_desc_formatShort format string giving a succinct description of the error. To be passed on to the user.
...Arguments for the format string.
Returns:
void
char* globus_error_get_long_desc ( globus_object_t *  error)

Retrieve the long error description from a generic globus error object.

Parameters:
errorThe error from which to retrieve the description
Returns:
The long error description of the object
void globus_error_set_long_desc ( globus_object_t *  error,
const char *  long_desc_format,
  ... 
)

Set the long error description in a generic globus error object.

Parameters:
errorThe error object for which to set the description
long_desc_formatLonger format string giving a more detailed explanation of the error.
Returns:
void