The Query Host Update function lets the programmed operator determine if the host has updated the host presentation space or OIA because:
• | The previous call to the Query Host Update function (for all calls to the Query Host Update function except the first). |
Prerequisite Calls
Start Host Notification (23)
Call Parameters
|
Standard Interface
|
Enhanced Interface
|
Function Number
|
Must be 24
|
|
Data String
|
1-character short name of the host presentation space, or a blank or null indicating request for updates to host-connected presentation space
|
|
Length
|
1 is implied
|
4 is implied
|
PS Position
|
NA
|
|
The calling data string can contain:
Byte
|
|
Definition
|
Standard
|
Enhanced
|
|
1
|
1
|
A 1-character presentation space short name (PSID)
|
|
2-4
|
Reserved
|
Return Parameters
Return Code
|
Definition
|
0
|
No updates have been made since the last call.
|
1
|
An incorrect host presentation space was specified.
|
8
|
No prior Start Host Notification (23) function was called for the host presentation space ID.
|
9
|
A system error was encountered.
|
21
|
The OIA was updated.
|
22
|
The presentation space was updated.
|
23
|
Both the OIA and the host presentation space were updated.
|
44
|
Printing has completed in the printer session.
|
Remarks
The target presentation space must be specified in the data string, even though a connection to the host presentation space is not necessary to check for updates.
|