Return Parameters

This function returns a data string and a return code.
Data String:
If A (asynchronous) is specified in position 5, (2 for standard interface) and the function is completed successfully, the following data string is returned:
Byte Definition
Standard Enhanced  
9–10 13–14 2-byte function request ID. It is used by the Get Request Completion (125) function to determine the completion of this function call.
15–16 Reserved.
17–20 4-byte value in which the event object address is returned by EHLLAPI. The application can wait for this event object. When the event object is cleared, the application must issue the Get Request Completion (125) function call (32-bit only).
Note: A event object address is returned for each successful asynchronous request. The event object should not be used again. A new event object is returned for each request and is valid for only the duration of that request.
Data String:
If “M” (asynchronous message mode) is specified in position 5 (2 for 16-bit applications) and the function is completed successfully, the following data string is returned:
Byte Definition
9–10 13–14 A 2-byte function request ID. It is used by the Get Request Completion (125) function to determine the completion of this function call.
15–16 Reserved.
11–12 17–18 Task ID of asynchronous message mode.
19–20 Reserved.
Note: If the function is completed successfully, an application window receive a message. The message is a return value of RegisterWindowMessage (PCSHLL). The wParam parameter contains Task ID returned by the function call. The HIWORD of lParam parameter contains Return Code 0, which shows the function was successful, and LOWORD of lParam parameter contains function number 126.
Return Code:
The following codes are defined:
Return Code Explanation
0 The Read Structured Fields function was successful.
1 A specified host presentation space short session ID was not valid or was not connected.
2 An error was made in specifying parameters.
9 A system error occurred.
11 Resource unavailable (memory unavailable).
35 Request rejected. An outbound transmission from the host was canceled.
36 Request rejected. Lost contact with the host.
37 The function was successful, but the host is inbound disabled.