Return Parameters
This function returns a data string, a length, and a return code.
- Data String:
- The returned data string is 16n bytes long (12n for
standard interface), where n is the number of host sessions.
The descriptors are concatenated into the data string and each session
type, and presentation space size of a host session.
The format of each 16-byte (12-byte for standard interface) session descriptor is as follows:
Byte | Definition | |
---|---|---|
Standard | Enhanced | |
1 | 1 | A 1-character presentation space short name (PSID) |
2–4 | Reserved | |
2–9 | 5–12 | Session long name (same as profile name; or, if profile not set, same as short name) |
10 | 13 | Connection type H=host |
14 | Reserved | |
11–12 | 15–16 | Host presentation space size (this is a binary number and is not in display format). If the session type is a print session, the value is 0. |
- Length:
- The number of host sessions started.
- Return Code:
- The following codes are defined:
Return Code | Explanation |
---|---|
0 | The Query Sessions function was successful. |
2 | An incorrect string length was made. |
9 | A system error was encountered. |