OSI/MHS P7 Application Programmatic Interface (P7 API) Manual

Procedure Calls
OSI/MHS P7 Application Programmatic Interface (P7 API) Manual—424825-001
3-8
LOS_DT_FINISH_RESULT_
specifies whether there is more data to be received from OSI/MHS. moreData can
be ZMHS-VAL-DT-MORE-DATA or ZMHS-VAL-DT-NO-MORE-DATA.
Considerations
•
The contents of bufferPtr varies from one call to LOS_DT_FINISH_RESULT_
to the next. Therefore, the validity of the data is guaranteed only until the next call
to this procedure.
•
To determine the size of the APDU being transferred from OSI/MHS, specify a
buffer length of 0 bytes for the bufferLen parameter. The
LOS_DT_FINISH_RESULT_ procedure then returns the length of the buffer in
bytes.
•
The first call to LOS_DT_FINISH_RESULT_ does not return the dataType and
moreData parameters. You must call LOS_DT_FINISH_RESULT_ a second
time to obtain these output parameters.
If the first call to this procedure returns a buffer length of 0, you must call
LOS_DT_FINISH_RESULT_ again with a bufferLen of at least 1. A 0 returned
by the first call indicates either a BIND error or an MSUNBIND result.
•
For the REGISTER-MS operation LOS_DT_FINISH_RESULT_ returns the result
or error for the change-credentials, list-attribute-defaults, and fetch-attribute-defaults
arguments only. These are the only arguments accepted in this implementation.
•
A description of the content of the buffer can be found in 1988 CCITT
recommendations as follows:
•
X.413 MHS: Message store: abstract service definition contains the protocol
definitions for MSBIND result and error, SUMMARIZE result and error, LIST
result and error, FETCH result and error, DELETE result and error, and
REGISTER-MS result and error.
•
X.411 MHS: Message transfer system: abstract service definition and
procedures contains the protocol definitions for the SUBMISSION CONTROL
argument, MESSAGE SUBMISSION result and error, PROBE SUBMISSION
result and error, and CANCEL DEFERRED result and error.
•
X.229 Remote operations: protocol specification contains the protocol
definition for ROIV, RORS, ROER, and RORJ APDUs.
•
X.227 OSI: Association Control: protocol specification contains the protocol
definition for ACSE AARE-APDU user information.