SE OpenTransmittalByName

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

extern SE_Return_Code
SE_OpenTransmittalByName
(
const	SE_URN	*	transmittal_name,	¹
	SE_Encoding		encoding,	²
	SE_Access_Mode		access_mode,	³
	SE_Transmittal	*	transmittal	⁴
);

Definition

This function opens a transmittal for access, based on the mode specified by access_mode. 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(). If this function is successful, transmittal returns a handle to the newly opened transmittal.

Returns

SE_RETCOD_SUCCESS	and the opened tranmittal is returned.
SE_RETCOD_FAILURE	and the status code is set appropriately if the call failed.

Status Codes

SE_Status_Code(s) when SE_RETCOD_SUCCESS is returned:

SE_STATCODE_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_RETCOD_FAILURE is returned:

SE_STATCODE_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_STATCODE_UNRESOLVED_TRANSMITTAL	set if the API could not resolve the transmittal_name to a file location.
SE_STATCODE_TRANSMITTAL_INACCESSIBLE	set if the file location of the resolved transmittal name was not accessible by the API. This could occur if the transmittal was opened for read-only or update and the resolved file location did not exist, or if the resolved file location specified a non-local file and the API had no transport mechanism for accessing the remote file.
SE_STATCODE_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_STATCODE_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_STATCODE_INACTIONABLE_FAILURE	set if the call fails for any other reason.

Parameters Notes

¹ the formal name of the transmittal to be opened.

² 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().

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

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