SE OpenTransmittalByName

SEDRIS Reference Manual APPENDIX A - Transmittal Access Level 0 API Functions SE OpenTransmittalByName

extern SE_Return_Code
SE_OpenTransmittalByName
(
const	char		transmittal_name[],	(notes)
	SE_Encoding		encoding,	(notes)
	SE_Access_Mode		access_mode,	(notes)
	SE_Transmittal	*	transmittal_out_ptr	(notes)
);

Definition

Opens a transmittal for access based on the mode specified. This function specifies the transmittal to be opened using the formal transmittal name of the transmittal. The formal name of the transmittal is resolved automatically based on the process described for the function SE_ResolveTransmittalName().

Returns

SE_RET_CODE_SUCCESS	and the opened tranmittal is returned.
SE_RET_CODE_FAILURE	and the status code is set appropriately if the call failed.

Status Codes

SE_Status_Code(s) when SE_RET_CODE_SUCCESS is returned:

SE_STAT_CODE_SUCCESS set if valid parameters were passed in and the name was a valid transmittal name that the API could resolve and access.

SE_Status_Code(s) when SE_RET_CODE_FAILURE is returned:

SE_STAT_CODE_INVALID_TRANSMITTAL_NAME SE_STAT_CODE_INVALID_TRANSMITTAL_NAME set if the transmittal_name did not specify a name that was valid according to the format of the SEDRIS namespace.

SE_STAT_CODE_UNRESOLVED_TRANSMITTAL SE_STAT_CODE_UNRESOLVED_TRANSMITTAL set if the API could not resolve the transmittal_name to a file location.

SE_STAT_CODE_TRANSMITTAL_INACCESSIBLE SE_STAT_CODE_TRANSMITTAL_INACCESSIBLE set if the file location of the resolved transmittal name was not accessible by the API. This could occur if (1) the transmittal was opened for read-only or update and the resolved file location did not exist, or (2) if the resolved file location specified a non-local file and the API had no transport mechanism for accessing the remote file.

SE_STAT_CODE_INVALID_ACCESS_MODE SE_STAT_CODE_INVALID_ACCESS_MODE set if

the resolved file location was found, but the security permissions of the underlying system (OS / filesystem) prohibited access to the file in the mode specified. This could occur if the access mode specified was create or update and the file was marked read-only, or if no access was permitted for the account running the application.

if create or update mode was requested and the API implementation encoding does not support the write capability.

SE_STAT_CODE_UNSUPPORTED_ENCODING SE_STAT_CODE_UNSUPPORTED_ENCODING set if the resolved transmittal name referenced a format that is not supported by the implementation(s) encoding of the SEDRIS API linked to the application.

SE_STAT_CODE_INACTIONABLE_FAILURESE_STAT_CODE_INACTIONABLE_FAILURE set if the call fails for any other reason.

Parameters Notes

transmittal_name

 the formal name of the transmittal to be opened.

encoding

 identifies the API implementation encoding
    to use when opening this file.  If the specified API can't open the
    given file location then the API will return a status code indicating
    why it could not be opened.  If encoding is NULL, then
    the API will try to open the given transmittal based on the
    extension of the file location.

    See also SE_GetEncoding().

access_mode

 the mode (read-only, create, update, etc.) that the
     transmittal should be opened in.

transmittal_out_ptr

 a pointer to the SE_Transmittal from the user.
    The *transmittal_out_ptr value will be initialized by this function.

SE_STAT_CODE_INVALID_TRANSMITTAL_NAME SE_STAT_CODE_INVALID_TRANSMITTAL_NAME	set if the transmittal_name did not specify a name that was valid according to the format of the SEDRIS namespace.
SE_STAT_CODE_UNRESOLVED_TRANSMITTAL SE_STAT_CODE_UNRESOLVED_TRANSMITTAL	set if the API could not resolve the transmittal_name to a file location.
SE_STAT_CODE_TRANSMITTAL_INACCESSIBLE SE_STAT_CODE_TRANSMITTAL_INACCESSIBLE	set if the file location of the resolved transmittal name was not accessible by the API. This could occur if (1) the transmittal was opened for read-only or update and the resolved file location did not exist, or (2) if the resolved file location specified a non-local file and the API had no transport mechanism for accessing the remote file.
SE_STAT_CODE_INVALID_ACCESS_MODE SE_STAT_CODE_INVALID_ACCESS_MODE	set if the resolved file location was found, but the security permissions of the underlying system (OS / filesystem) prohibited access to the file in the mode specified. This could occur if the access mode specified was create or update and the file was marked read-only, or if no access was permitted for the account running the application. if create or update mode was requested and the API implementation encoding does not support the write capability.
SE_STAT_CODE_UNSUPPORTED_ENCODING SE_STAT_CODE_UNSUPPORTED_ENCODING	set if the resolved transmittal name referenced a format that is not supported by the implementation(s) encoding of the SEDRIS API linked to the application.
SE_STAT_CODE_INACTIONABLE_FAILURESE_STAT_CODE_INACTIONABLE_FAILURE	set if the call fails for any other reason.