2.2.4.3.1.1 Server Async Printer Properties Request (ASYNC_PRINTER_PROPS_REQ)
This request is sent from the server to the client, and causes the client to display a printer properties user interface.
|
|
|
|
|
|
|
|
|
|
1 |
|
|
|
|
|
|
|
|
|
2 |
|
|
|
|
|
|
|
|
|
3 |
|
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Header (variable) |
|||||||||||||||||||||||||||||||
... |
|||||||||||||||||||||||||||||||
Flags |
|||||||||||||||||||||||||||||||
hServerWindow |
|||||||||||||||||||||||||||||||
... |
|||||||||||||||||||||||||||||||
Reserved |
|||||||||||||||||||||||||||||||
Callback |
Header (variable): The common message header (as specified in section 2.2.1). The InterfaceId field MUST be set to 0x00000000. The FunctionId field MUST be set to ASYNC_PRINTER_PROPS_REQ (0x00000107).
Flags (4 bytes): A 32-bit unsigned integer. The value of this field is used to determine the privilege level used to query for printer properties. Flags MUST be one of the following values.
-
Value
Meaning
XPSREDIR_PRINTER_PROPERTIES_Flags_WITH_PERMISSION
0x00000000
If this value is set, the printer properties are queried with administrative privilege.
XPSREDIR_PRINTER_PROPERTIES_Flags_NO_PERMISSION
0x00000001
If this value is set, the printer properties are queried with user privilege.
hServerWindow (8 bytes): A 64-bit unsigned integer. When an operating system calls into the server virtual printer driver to display the printer properties UI, it also supplies a WindowHandle to use as a parent for the UI displayed. The WindowHandle is passed to the client printer driver in this field.
Reserved (4 bytes): A 32-bit unsigned integer. This field MUST be set to 0x00000001.
Callback (4 bytes): A 32-bit unsigned integer. This value represents a unique InterfaceId (as described in section 3.1.1) that MUST be used in the InterfaceId field of a PRINTER_PROPS_CALLBACK_REQ request message.