Definition

Given an character string representing a formal SEDRIS transmittal name, returns the file location associated with this name. This function invokes the SEDRIS namespace resolver as described in the SEDRIS documentation set.

The format of a valid SEDRIS name is as follows:

urn:sedris:<delegated_creation_authority>:<assigned_transmittal_name> [:<transmittal_version_serial>]

NOTE: in the format shown above there must be no white space or carriage control characters within or between the sub-fields.

The format as described here is for cursory information only. Please consult the SEDRIS documentation set for a complete and formal description of the SEDRIS namespace and resolution process.

The first 11 characters are required fields that represent a sentinel for the SEDRIS namespace. These fields must be present for the name string to be considered valid.

The <delegated_creation_authority> is the string representing the portion of the SEDRIS namespace that has been delegated by the SEDRIS namespace registrar to the group, organization, or body that has authority for the assignment of transmittal named within the delegated namespace. This string may represent a sub-delegation by the registered authority to another group, organization or body.

The <assigned_transmittal_name> is the string representing a specific transmittal, and the optional <transmittal_version_serial> allows for a more specific designation of the transmittal to resolve. The rules governing the naming and versioning of SEDRIS transmittals are described more fully in the SEDRIS documentation set.

Returns

SE_STAT_CODE_SUCCESS	and *file_location_out_ptr is set to the file location associated with the transmittal, if valid parameters were passed in and the transmittal name was successfully resolved.
SE_STAT_CODE_NULL_REQUIRED_PARAMETER	and *file_location_out_ptr is left unaltered, if transmittal_name_in or file_location_out_ptr is NULL.
SE_STAT_CODE_INVALID_OR_NULL_STORE	and *file_location_out_ptr is set to NULL, if store_in is not a handle to a valid SE_Store created by SE_CreateStore().
SE_STAT_CODE_INVALID_TRANSMITTAL_NAME	and *file_location_out_ptr is set to NULL, if the transmittal_name_in parameter did not specify a name that was valid according to the formal SEDRIS namespace. See the comment in the function description above about the nature of the validation done.
SE_STAT_CODE_UNRESOLVED_TRANSMITTAL	and *file_location_out_ptr is set to NULL, if the API could not resolve the transmittal_name_in to a file location.
SE_STAT_CODE_OUT_OF_MEMORY	and *file_location_out_ptr is set to NULL, if the API could not allocate the memory for the file location string in the file_location_out_ptr.
SE_STAT_CODE_FAILURE	and *file_location_out_ptr is set to NULL, if the API implementation specified does not provide this function in its shared library, and dynamic binding is specified at compile time.

Parameters Notes

transmittal_name_in

 a pointer to character array specifying a valid
    transmittal name in the formal SEDRIS namespace.  This parameter is
    validated only based upon the structured format of the name string as
    described above.  That is, the sub-fields within the string are only
    checked for proper structure (character set, delimiters, etc.) and are
    NOT checked for consistency with namespace delegation rules, and proper
    use of transmittal versioning.

store_in

 the store to be used when allocated the string used to return
    the file location.

file_location_out_ptr

 a pointer to a char* variable from the user.
    The file location will be returned via this pointer.  The storage for
    the character string returned in this structure will be allocated within
    the store passed in.

Prev: SE_ResolveObject. Next: SE_SetCallbackForOneFunctionOneStatusCode. Up:Index.

Last updated: May 15, 2003 Copyright © 2003 SEDRIS™