Given a handle to a transmittal, return the formal transmittal name
associated with the transmittal.
SE_NULL_REQUIRED_PARAMETER - and *name_out_ptr is left unaltered, if either name_out_ptr or store_in is NULL.
SE_INVALID_OR_NULL_TRANSMITTAL - and *name_out_ptr is set to NULL, if transmittal_in is not a handle to a valid, open SEDRIS transmittal.
SE_INVALID_OR_NULL_STORE - and *name_out_ptr is set to NULL, if store_in is not a handle to a valid, active (i.e., not freed) SE_STORE created by SE_CreateStore().
SE_OUT_OF_MEMORY - and *name_out_ptr is set to NULL, if the API could not allocate the memory for the name string in name_out_ptr.
SE_FAILURE - and *name_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.
| extern SE_STATUS_CODE_ENUM | ||||
| SE_GetTransmittalName | ||||
| ( | ||||
| SE_TRANSMITTAL | transmittal_in, | (notes) | ||
| SE_STORE | store_in, | (notes) | ||
| char | * | * | name_out_ptr | (notes) |
| ); | ||||
the transmittal for which the name is being requested.
the store to be used when allocating the string used to return
the transmittal name.
a pointer to a char* variable from the user.
A pointer to the transmittal name will be returned via this parameter.
The storage for the character string returned will be allocated within
the store passed in.