SEDRIS Reference Manual
APPENDIX A - Transmittal Access Level 0 API
Functions
SE GetTransmittalVersionInformation
extern SE_Return_Code
SE_GetTransmittalVersionInformation
(
SE_Transmittal  transmittal,1
SE_Short_Integer_Positive  *major_DRM_version,2
SE_Byte_Unsigned  *minor_DRM_version,3
SE_Character  *interim_DRM_version,4
SE_Short_Integer_Positive  *major_EDCS_version,5
SE_Byte_Unsigned  *minor_EDCS_version,6
SE_Character  *interim_EDCS_version,7
SE_Short_Integer_Positive  *major_SRM_version,8
SE_Byte_Unsigned  *minor_SRM_version,9
SE_Character  *interim_SRM_version10
);

Definition

This function returns the versions of the implementations of the DRM, EDCS, and SRM used to define the given transmittal.

Major versions are specified by an integer that is incremented whenever large changes are made to the implementation.

Minor versions are specified by an integer that is incremented whenever any small changes are made to the implementation.

Interim versions are specified using a lower case letter that is incremented whenever a new interim version of the implementation is released.


Returns

SE_RETCOD_SUCCESS and the transmittal version information 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 all operations succeeded.

SE_Status_Code(s) when SE_RETCOD_FAILURE is returned:

SE_STATCODE_INACTIONABLE_FAILURE set if the call fails for any reason.


Parameters Notes

1 the transmittal whose version information is being obtained

2 a pointer to a SE_Short_Integer_Positive in the user's memory space that will be set to an integer value greater than or equal to 1

3 a pointer to a SE_Byte_Unsigned in the user's memory space that will be set to an integer value between 0 and 99, inclusive

4 a pointer to an SE_Character in the user's memory space that will be set to a value between 'a' and 'z' inclusive. If it was not an interim version of the DRM, then the value will be set to '\0'.

5 a pointer to a SE_Short_Integer_Positive in the user's memory space that will be set to an integer value greater than or equal to 1

6 a pointer to a SE_Byte_Unsigned in the user's memory space that will be set to an integer value between 0 and 99, inclusive

7 a pointer to a SE_Character in the user's memory space that will be set to a value between 'a' and 'z' inclusive. If it was not an interim version of the EDCS, then the value will be set to '\0'.

8 a pointer to a SE_Short_Integer_Positive in the user's memory space that will be set to an integer value greater than or equal to 1

9 a pointer to a SE_Byte_Unsigned in the user's memory space that will be set to an integer value between 0 and 99, inclusive

10 a pointer to a SE_Character in the user's memory space that will be set to a value between 'a' and 'z' inclusive. If it was not an interim version of the SRM, then the value will be set to '\0'.


Prev: SE_GetTransmittalName. Next: SE_GetUniqueTransmittalID. Up:Index.