4 spoolss interface definitions
6 import "misc.idl", "security.idl", "winreg.idl";
8 [ uuid("12345678-1234-abcd-ef00-0123456789ab"),
10 endpoint("ncacn_np:[\\pipe\\spoolss]"),
11 pointer_default(unique),
12 helpstring("Spooler SubSystem"),
13 helper("../librpc/ndr/ndr_spoolss_buf.h")
16 typedef [v1_enum] enum winreg_Type winreg_Type;
29 [relative] nstring *printername;
30 [relative] nstring *servername;
35 uint32 global_counter;
41 uint32 session_counter;
43 uint32 printer_errors;
58 } spoolss_PrinterInfo0;
60 typedef [public,gensize] struct {
61 [charset(UTF16)] uint16 devicename[32];
65 [value(r->driverextra_data.length)] uint16 __driverextra_length;
80 [charset(UTF16)] uint16 formname[32];
86 uint32 displayfrequency;
95 [subcontext_size(__driverextra_length),subcontext(0),flag(NDR_REMAINING)] DATA_BLOB driverextra_data;
98 typedef [public] bitmap {
99 PRINTER_ENUM_DEFAULT = 0x00000001,
100 PRINTER_ENUM_LOCAL = 0x00000002,
101 PRINTER_ENUM_CONNECTIONS = 0x00000004,
102 PRINTER_ENUM_FAVORITE = 0x00000004,
103 PRINTER_ENUM_NAME = 0x00000008,
104 PRINTER_ENUM_REMOTE = 0x00000010,
105 PRINTER_ENUM_SHARED = 0x00000020,
106 PRINTER_ENUM_NETWORK = 0x00000040,
107 PRINTER_ENUM_EXPAND = 0x00004000,
108 PRINTER_ENUM_CONTAINER = 0x00008000,
109 PRINTER_ENUM_ICON1 = 0x00010000,
110 PRINTER_ENUM_ICON2 = 0x00020000,
111 PRINTER_ENUM_ICON3 = 0x00040000,
112 PRINTER_ENUM_ICON4 = 0x00080000,
113 PRINTER_ENUM_ICON5 = 0x00100000,
114 PRINTER_ENUM_ICON6 = 0x00200000,
115 PRINTER_ENUM_ICON7 = 0x00400000,
116 PRINTER_ENUM_ICON8 = 0x00800000,
117 PRINTER_ENUM_HIDE = 0x01000000
118 } spoolss_EnumPrinterFlags;
121 spoolss_EnumPrinterFlags flags;
122 [relative] nstring *name;
123 [relative] nstring *description;
124 [relative] nstring *comment;
125 } spoolss_PrinterInfo1;
128 PRINTER_ATTRIBUTE_QUEUED = 0x00000001,
129 PRINTER_ATTRIBUTE_DIRECT = 0x00000002,
130 PRINTER_ATTRIBUTE_DEFAULT = 0x00000004,
131 PRINTER_ATTRIBUTE_SHARED = 0x00000008,
132 PRINTER_ATTRIBUTE_NETWORK = 0x00000010,
133 PRINTER_ATTRIBUTE_HIDDEN = 0x00000020,
134 PRINTER_ATTRIBUTE_LOCAL = 0x00000040,
135 PRINTER_ATTRIBUTE_ENABLE_DEVQ = 0x00000080,
136 PRINTER_ATTRIBUTE_KEEPPRINTEDJOBS = 0x00000100,
137 PRINTER_ATTRIBUTE_DO_COMPLETE_FIRST = 0x00000200,
138 PRINTER_ATTRIBUTE_WORK_OFFLINE = 0x00000400,
139 PRINTER_ATTRIBUTE_ENABLE_BIDI = 0x00000800,
140 PRINTER_ATTRIBUTE_RAW_ONLY = 0x00001000,
141 PRINTER_ATTRIBUTE_PUBLISHED = 0x00002000,
142 PRINTER_ATTRIBUTE_FAX = 0x00004000,
143 PRINTER_ATTRIBUTE_TS = 0x00008000
144 } spoolss_PrinterAttributes;
147 PRINTER_STATUS_PAUSED = 0x00000001,
148 PRINTER_STATUS_ERROR = 0x00000002,
149 PRINTER_STATUS_PENDING_DELETION = 0x00000004,
150 PRINTER_STATUS_PAPER_JAM = 0x00000008,
151 PRINTER_STATUS_PAPER_OUT = 0x00000010,
152 PRINTER_STATUS_MANUAL_FEED = 0x00000020,
153 PRINTER_STATUS_PAPER_PROBLEM = 0x00000040,
154 PRINTER_STATUS_OFFLINE = 0x00000080,
155 PRINTER_STATUS_IO_ACTIVE = 0x00000100,
156 PRINTER_STATUS_BUSY = 0x00000200,
157 PRINTER_STATUS_PRINTING = 0x00000400,
158 PRINTER_STATUS_OUTPUT_BIN_FULL = 0x00000800,
159 PRINTER_STATUS_NOT_AVAILABLE = 0x00001000,
160 PRINTER_STATUS_WAITING = 0x00002000,
161 PRINTER_STATUS_PROCESSING = 0x00004000,
162 PRINTER_STATUS_INITIALIZING = 0x00008000,
163 PRINTER_STATUS_WARMING_UP = 0x00010000,
164 PRINTER_STATUS_TONER_LOW = 0x00020000,
165 PRINTER_STATUS_NO_TONER = 0x00040000,
166 PRINTER_STATUS_PAGE_PUNT = 0x00080000,
167 PRINTER_STATUS_USER_INTERVENTION= 0x00100000,
168 PRINTER_STATUS_OUT_OF_MEMORY = 0x00200000,
169 PRINTER_STATUS_DOOR_OPEN = 0x00400000,
170 PRINTER_STATUS_SERVER_UNKNOWN = 0x00800000,
171 PRINTER_STATUS_POWER_SAVE = 0x01000000
172 } spoolss_PrinterStatus;
175 [relative] nstring *servername;
176 [relative] nstring *printername;
177 [relative] nstring *sharename;
178 [relative] nstring *portname;
179 [relative] nstring *drivername;
180 [relative] nstring *comment;
181 [relative] nstring *location;
182 [relative,subcontext(0)] spoolss_DeviceMode *devmode;
183 [relative] nstring *sepfile;
184 [relative] nstring *printprocessor;
185 [relative] nstring *datatype;
186 [relative] nstring *parameters;
187 [relative,subcontext(0)] security_descriptor *secdesc;
188 spoolss_PrinterAttributes attributes;
190 uint32 defaultpriority;
193 spoolss_PrinterStatus status;
196 } spoolss_PrinterInfo2;
199 [relative,subcontext(0)] security_descriptor *secdesc;
200 } spoolss_PrinterInfo3;
203 [relative] nstring *printername;
204 [relative] nstring *servername;
205 spoolss_PrinterAttributes attributes;
206 } spoolss_PrinterInfo4;
209 [relative] nstring *printername;
210 [relative] nstring *portname;
211 spoolss_PrinterAttributes attributes;
212 uint32 device_not_selected_timeout;
213 uint32 transmission_retry_timeout;
214 } spoolss_PrinterInfo5;
217 spoolss_PrinterStatus status;
218 } spoolss_PrinterInfo6;
221 DSPRINT_PUBLISH = 0x00000001,
222 DSPRINT_UPDATE = 0x00000002,
223 DSPRINT_UNPUBLISH = 0x00000004,
224 DSPRINT_REPUBLISH = 0x00000008,
225 DSPRINT_PENDING = 0x80000000
226 } spoolss_DsPrintAction;
229 [relative] nstring *guid; /* text form of printer guid */
230 spoolss_DsPrintAction action;
231 } spoolss_PrinterInfo7;
234 [relative,subcontext(0)] spoolss_DeviceMode *devmode;
235 } spoolss_DeviceModeInfo;
237 typedef [nodiscriminant,relative_base,public] union {
238 [case(0)] spoolss_PrinterInfo0 info0;
239 [case(1)] spoolss_PrinterInfo1 info1;
240 [case(2)] spoolss_PrinterInfo2 info2;
241 [case(3)] spoolss_PrinterInfo3 info3;
242 [case(4)] spoolss_PrinterInfo4 info4;
243 [case(5)] spoolss_PrinterInfo5 info5;
244 [case(6)] spoolss_PrinterInfo6 info6;
245 [case(7)] spoolss_PrinterInfo7 info7;
246 [case(8)] spoolss_DeviceModeInfo info8;
247 [case(9)] spoolss_DeviceModeInfo info9;
249 } spoolss_PrinterInfo;
253 /* we are using this as internal parsing code */
254 [public,noopnum,noprint] WERROR _spoolss_EnumPrinters(
255 [in] spoolss_EnumPrinterFlags flags,
256 [in,unique] [string,charset(UTF16)] uint16 *server,
258 [in,unique] DATA_BLOB *buffer,
260 [out,unique] DATA_BLOB *info,
264 [public,noopnum,noprint] void __spoolss_EnumPrinters(
267 [out,switch_is(level)] spoolss_PrinterInfo info[count]
269 [nopull,nopush] WERROR spoolss_EnumPrinters(
270 [in] spoolss_EnumPrinterFlags flags,
271 [in,unique] [string,charset(UTF16)] uint16 *server,
273 [in,unique] DATA_BLOB *buffer,
275 /* what we have here is a subcontext containing an array of no discriminant unions
276 * and the array has no size in front
278 [out,unique,switch_is(level),size_is(count)] spoolss_PrinterInfo *info,
286 [value(_ndr_size_spoolss_DeviceMode(devmode, ndr->iconv_convenience, ndr->flags))] uint32 _ndr_size;
287 [subcontext(4),subcontext_size(_ndr_size)] spoolss_DeviceMode *devmode;
288 } spoolss_DevmodeContainer;
290 [public] WERROR spoolss_OpenPrinter(
291 [in,unique] [string,charset(UTF16)] uint16 *printername,
292 [in,unique] [string,charset(UTF16)] uint16 *datatype,
293 [in] spoolss_DevmodeContainer devmode_ctr,
294 [in] uint32 access_mask,
295 [out,ref] policy_handle *handle
302 [relative] nstring *printer_name;
303 [relative] nstring *server_name;
304 [relative] nstring *user_name;
305 [relative] nstring *document_name;
306 [relative] nstring *data_type;
307 [relative] nstring *text_status;
312 uint32 pages_printed;
316 typedef [nodiscriminant,relative_base,public] union {
317 [case(1)] spoolss_JobInfo1 info1;
318 [case(2)]; /* TODO */
319 [case(3)]; /* TODO */
325 [switch_is(level)] spoolss_JobInfo info;
326 } spoolss_JobInfoContainer;
328 typedef [v1_enum] enum {
329 SPOOLSS_JOB_CONTROL_PAUSE = 1,
330 SPOOLSS_JOB_CONTROL_RESUME = 2,
331 SPOOLSS_JOB_CONTROL_CANCEL = 3,
332 SPOOLSS_JOB_CONTROL_RESTART = 4,
333 SPOOLSS_JOB_CONTROL_DELETE = 5,
334 SPOOLSS_JOB_CONTROL_SEND_TO_PRINTER = 6,
335 SPOOLSS_JOB_CONTROL_LAST_PAGE_EJECTED = 7
336 } spoolss_JobControl;
338 WERROR spoolss_SetJob(
339 [in,ref] policy_handle *handle,
341 [in,unique] spoolss_JobInfoContainer *ctr,
342 [in] spoolss_JobControl command
347 WERROR spoolss_GetJob(
348 [in,ref] policy_handle *handle,
351 [in,unique] DATA_BLOB *buffer,
353 [out,unique,subcontext(4),subcontext_size(offered),switch_is(level)] spoolss_JobInfo *info,
359 [public,noopnum,noprint] WERROR _spoolss_EnumJobs(
360 [in,ref] policy_handle *handle,
361 [in] uint32 firstjob,
364 [in,unique] DATA_BLOB *buffer,
366 [out,unique] DATA_BLOB *info,
370 [public,noopnum,noprint] void __spoolss_EnumJobs(
373 [out,switch_is(level)] spoolss_JobInfo info[count]
375 [nopull,nopush] WERROR spoolss_EnumJobs(
376 [in,ref] policy_handle *handle,
377 [in] uint32 firstjob,
380 [in,unique] DATA_BLOB *buffer,
382 [out,unique,switch_is(level),size_is(count)] spoolss_JobInfo *info,
389 [todo] WERROR spoolss_AddPrinter(
390 /* This function is not implemented in Samba 3 as no
391 clients have been observed using it. */
396 WERROR spoolss_DeletePrinter(
397 [in] policy_handle *handle
402 typedef [v1_enum] enum {
403 SPOOLSS_PRINTER_CONTROL_UNPAUSE = 0,
404 SPOOLSS_PRINTER_CONTROL_PAUSE = 1,
405 SPOOLSS_PRINTER_CONTROL_RESUME = 2,
406 SPOOLSS_PRINTER_CONTROL_PURGE = 3,
407 SPOOLSS_PRINTER_CONTROL_SET_STATUS = 4
408 } spoolss_PrinterControl;
410 typedef [switch_type(uint32)] union {
411 [case(0)] spoolss_PrinterInfo0 *info0;
412 [case(1)] spoolss_PrinterInfo1 *info1;
413 [case(2)] spoolss_PrinterInfo2 *info2;
414 [case(3)] spoolss_PrinterInfo3 *info3;
415 [case(4)] spoolss_PrinterInfo4 *info4;
416 [case(5)] spoolss_PrinterInfo5 *info5;
417 [case(6)] spoolss_PrinterInfo6 *info6;
418 [case(7)] spoolss_PrinterInfo7 *info7;
419 [case(8)] spoolss_DeviceModeInfo *info8;
420 [case(9)] spoolss_DeviceModeInfo *info9;
422 } spoolss_SetPrinterInfo;
424 WERROR spoolss_SetPrinter(
425 [in,ref] policy_handle *handle,
427 [in,switch_is(level)] spoolss_SetPrinterInfo info,
428 [in] spoolss_DevmodeContainer devmode_ctr,
429 [in] sec_desc_buf secdesc_ctr,
430 [in] spoolss_PrinterControl command
435 [public] WERROR spoolss_GetPrinter(
436 [in,ref] policy_handle *handle,
438 [in,unique] DATA_BLOB *buffer,
440 [out,unique,subcontext(4),subcontext_size(offered),switch_is(level)] spoolss_PrinterInfo *info,
446 [todo] WERROR spoolss_AddPrinterDriver(
450 [relative] nstring *driver_name;
451 } spoolss_DriverInfo1;
453 typedef [v1_enum] enum {
454 SPOOLSS_DRIVER_VERSION_9X = 0,
455 SPOOLSS_DRIVER_VERSION_NT35 = 1,
456 SPOOLSS_DRIVER_VERSION_NT4 = 2,
457 SPOOLSS_DRIVER_VERSION_200X = 3
458 } spoolss_DriverOSVersion;
461 spoolss_DriverOSVersion version;
462 [relative] nstring *driver_name;
463 [relative] nstring *architecture;
464 [relative] nstring *driver_path;
465 [relative] nstring *data_file;
466 [relative] nstring *config_file;
467 } spoolss_DriverInfo2;
470 spoolss_DriverOSVersion version;
471 [relative] nstring *driver_name;
472 [relative] nstring *architecture;
473 [relative] nstring *driver_path;
474 [relative] nstring *data_file;
475 [relative] nstring *config_file;
476 [relative] nstring *help_file;
477 [relative] nstring_array *dependent_files;
478 [relative] nstring *monitor_name;
479 [relative] nstring *default_datatype;
480 } spoolss_DriverInfo3;
483 spoolss_DriverOSVersion version;
484 [relative] nstring *driver_name;
485 [relative] nstring *architecture;
486 [relative] nstring *driver_path;
487 [relative] nstring *data_file;
488 [relative] nstring *config_file;
489 [relative] nstring *help_file;
490 [relative] nstring_array *dependent_files;
491 [relative] nstring *monitor_name;
492 [relative] nstring *default_datatype;
493 [relative] nstring_array *previous_names;
494 } spoolss_DriverInfo4;
497 spoolss_DriverOSVersion version;
498 [relative] nstring *driver_name;
499 [relative] nstring *architecture;
500 [relative] nstring *driver_path;
501 [relative] nstring *data_file;
502 [relative] nstring *config_file;
503 uint32 driver_attributes;
504 uint32 config_version;
505 uint32 driver_version;
506 } spoolss_DriverInfo5;
509 spoolss_DriverOSVersion version;
510 [relative] nstring *driver_name;
511 [relative] nstring *architecture;
512 [relative] nstring *driver_path;
513 [relative] nstring *data_file;
514 [relative] nstring *config_file;
515 [relative] nstring *help_file;
516 [relative] nstring_array *dependent_files;
517 [relative] nstring *monitor_name;
518 [relative] nstring *default_datatype;
519 [relative] nstring_array *previous_names;
521 hyper driver_version;
522 [relative] nstring *manufacturer_name;
523 [relative] nstring *manufacturer_url;
524 [relative] nstring *hardware_id;
525 [relative] nstring *provider;
526 } spoolss_DriverInfo6;
528 typedef [nodiscriminant,relative_base,public] union {
529 [case(1)] spoolss_DriverInfo1 info1;
530 [case(2)] spoolss_DriverInfo2 info2;
531 [case(3)] spoolss_DriverInfo3 info3;
532 [case(4)] spoolss_DriverInfo4 info4;
533 [case(5)] spoolss_DriverInfo5 info5;
534 [case(6)] spoolss_DriverInfo6 info6;
536 } spoolss_DriverInfo;
540 [public,noopnum,noprint] WERROR _spoolss_EnumPrinterDrivers(
541 [in,unique] [string,charset(UTF16)] uint16 *server,
542 [in,unique] [string,charset(UTF16)] uint16 *environment,
544 [in,unique] DATA_BLOB *buffer,
546 [out,unique] DATA_BLOB *info,
550 [public,noopnum,noprint] void __spoolss_EnumPrinterDrivers(
553 [out,switch_is(level)] spoolss_DriverInfo info[count]
555 [nopull,nopush] WERROR spoolss_EnumPrinterDrivers(
556 [in,unique] [string,charset(UTF16)] uint16 *server,
557 [in,unique] [string,charset(UTF16)] uint16 *environment,
559 [in,unique] DATA_BLOB *buffer,
561 [out,unique,switch_is(level),size_is(count)] spoolss_DriverInfo *info,
568 [todo] WERROR spoolss_GetPrinterDriver(
574 nstring directory_name;
575 } spoolss_DriverDirectoryInfo1;
577 /* NOTE: it's seems that w2k3 completly ignores the level
580 typedef [nodiscriminant,relative_base,gensize,public] union {
581 [case(1)] spoolss_DriverDirectoryInfo1 info1;
582 [default] spoolss_DriverDirectoryInfo1 info1;
583 } spoolss_DriverDirectoryInfo;
585 [public] WERROR spoolss_GetPrinterDriverDirectory(
586 [in,unique] [string,charset(UTF16)] uint16 *server,
587 [in,unique] [string,charset(UTF16)] uint16 *environment,
589 [in,unique] DATA_BLOB *buffer,
591 [out,unique,subcontext(4),subcontext_size(offered),switch_is(level)] spoolss_DriverDirectoryInfo *info,
597 WERROR spoolss_DeletePrinterDriver(
598 [in,ref] policy_handle *handle,
599 [in,unique] [string,charset(UTF16)] uint16 *server,
600 [in] [string,charset(UTF16)] uint16 architecture[],
601 [in] [string,charset(UTF16)] uint16 driver[]
606 [todo] WERROR spoolss_AddPrintProcessor(
612 [relative] nstring *print_processor_name;
613 } spoolss_PrintProcessorInfo1;
615 typedef [nodiscriminant,relative_base,public] union {
616 [case(1)] spoolss_PrintProcessorInfo1 info1;
618 } spoolss_PrintProcessorInfo;
620 [public,noopnum,noprint] WERROR _spoolss_EnumPrintProcessors(
621 [in,unique] [string,charset(UTF16)] uint16 *servername,
622 [in,unique] [string,charset(UTF16)] uint16 *environment,
624 [in,unique] DATA_BLOB *buffer,
626 [out,unique] DATA_BLOB *info,
630 [public,noopnum,noprint] void __spoolss_EnumPrintProcessors(
633 [out,switch_is(level)] spoolss_PrintProcessorInfo info[count]
635 [nopull,nopush] WERROR spoolss_EnumPrintProcessors(
636 [in,unique] [string,charset(UTF16)] uint16 *servername,
637 [in,unique] [string,charset(UTF16)] uint16 *environment,
639 [in,unique] DATA_BLOB *buffer,
641 [out,unique,switch_is(level),size_is(count)] spoolss_PrintProcessorInfo *info,
648 [todo] WERROR spoolss_GetPrintProcessorDirectory(
654 [string,charset(UTF16)] uint16 *document_name;
655 [string,charset(UTF16)] uint16 *output_file;
656 [string,charset(UTF16)] uint16 *datatype;
657 } spoolss_DocumentInfo1;
659 typedef [switch_type(uint32)] union {
660 [case(1)] spoolss_DocumentInfo1 *info1;
661 [case(2)]; /* TODO */
662 [case(3)]; /* TODO */
664 } spoolss_DocumentInfo;
666 WERROR spoolss_StartDocPrinter(
667 [in,ref] policy_handle *handle,
669 [in,switch_is(level)] spoolss_DocumentInfo info,
675 WERROR spoolss_StartPagePrinter(
676 [in,ref] policy_handle *handle
681 WERROR spoolss_WritePrinter(
682 [in,ref] policy_handle *handle,
684 [in,value(r->in.data.length)] uint32 _data_size,
685 [out] uint32 num_written
690 WERROR spoolss_EndPagePrinter(
691 [in,ref] policy_handle *handle
696 WERROR spoolss_AbortPrinter(
697 [in,ref] policy_handle *handle
702 WERROR spoolss_ReadPrinter(
703 [in,ref] policy_handle *handle,
704 [in] uint32 data_size,
705 [out] DATA_BLOB data,
706 [out,value(r->out.data.length)] uint32 _data_size
711 WERROR spoolss_EndDocPrinter(
712 [in,ref] policy_handle *handle
717 [todo] WERROR spoolss_AddJob(
722 [todo] WERROR spoolss_ScheduleJob(
727 const string SPOOLSS_ARCHITECTURE_NT_X86 = "Windows NT x86";
729 typedef [public,gensize] struct {
730 [value(ndr_size_spoolss_OSVersion(r,ndr->iconv_convenience,ndr->flags))] uint32 _ndr_size;
734 [value(2)] uint32 unknown;
735 [subcontext(0),subcontext_size(256)] nstring extra_string;
738 typedef [public,gensize] struct {
739 [value(ndr_size_spoolss_OSVersionEx(r,ndr->iconv_convenience,ndr->flags))] uint32 _ndr_size;
743 [value(2)] uint32 unknown1;
744 [subcontext(0),subcontext_size(256)] nstring extra_string;
745 uint32 unknown2;/* service pack number? I saw 0 from w2k3 and 1 from winxp sp1*/
746 uint32 unknown3;/* hmm? w2k3: 131346(0x20112) winxp sp1: 503382272 0x1E010100 */
747 } spoolss_OSVersionEx;
749 typedef [v1_enum] enum {
750 SPOOLSS_PRINTER_DATA_TYPE_NULL = 0,
751 SPOOLSS_PRINTER_DATA_TYPE_STRING = 1,
752 SPOOLSS_PRINTER_DATA_TYPE_BINARY = 3,
753 SPOOLSS_PRINTER_DATA_TYPE_UINT32 = 4,
754 SPOOLSS_PRINTER_DATA_TYPE_STRING_ARRAY = 7
755 } spoolss_PrinterDataType;
757 typedef [nodiscriminant,public,gensize] union {
758 [case(SPOOLSS_PRINTER_DATA_TYPE_NULL)];
759 [case(SPOOLSS_PRINTER_DATA_TYPE_STRING)] nstring string;
760 [case(SPOOLSS_PRINTER_DATA_TYPE_BINARY),flag(NDR_REMAINING)] DATA_BLOB binary;
761 [case(SPOOLSS_PRINTER_DATA_TYPE_UINT32)] uint32 value;
762 [case(SPOOLSS_PRINTER_DATA_TYPE_STRING_ARRAY)] nstring_array string_array;
763 [default,flag(NDR_REMAINING)] DATA_BLOB data;
764 } spoolss_PrinterData;
766 [noopnum,noprint,public] WERROR _spoolss_GetPrinterData(
767 [in,ref] policy_handle *handle,
768 [in] [string,charset(UTF16)] uint16 value_name[],
770 [out] spoolss_PrinterDataType type,
771 [out] DATA_BLOB data,
774 [noopnum,noprint,public] void __spoolss_GetPrinterData(
775 [in] spoolss_PrinterDataType type,
776 [out,switch_is(type)] spoolss_PrinterData data
778 [nopull,nopush,public] WERROR spoolss_GetPrinterData(
779 [in,ref] policy_handle *handle,
780 [in] [string,charset(UTF16)] uint16 value_name[],
782 [out] spoolss_PrinterDataType type,
783 [out,subcontext(4),subcontext_size(offered),switch_is(type)] spoolss_PrinterData data,
789 [noopnum,nopull,noprint,public] WERROR _spoolss_SetPrinterData(
790 [in,ref] policy_handle *handle,
791 [in] [string,charset(UTF16)] uint16 value_name[],
792 [in] spoolss_PrinterDataType type,
796 [noopnum,nopull,noprint,public] void __spoolss_SetPrinterData(
797 [in] spoolss_PrinterDataType type,
798 [out,switch_is(type)] spoolss_PrinterData data
800 [nopush] WERROR spoolss_SetPrinterData(
801 [in,ref] policy_handle *handle,
802 [in] [string,charset(UTF16)] uint16 value_name[],
803 [in] spoolss_PrinterDataType type,
804 [in,subcontext(4),switch_is(type)] spoolss_PrinterData data,
805 [in,value(ndr_size_spoolss_PrinterData(&data,type,ndr->iconv_convenience,flags))] uint32 _offered
810 [todo] WERROR spoolss_WaitForPrinterChange(
815 [public] WERROR spoolss_ClosePrinter(
816 [in,out,ref] policy_handle *handle
821 typedef [v1_enum] enum {
822 SPOOLSS_FORM_USER = 0,
823 SPOOLSS_FORM_BUILTIN = 1,
824 SPOOLSS_FORM_PRINTER = 2
840 spoolss_FormFlags flags;
841 [relative] nstring *form_name;
842 spoolss_FormSize size;
843 spoolss_FormArea area;
846 typedef [nodiscriminant,relative_base,public,gensize] union {
847 [case(1)] spoolss_FormInfo1 info1;
852 spoolss_FormFlags flags;
853 [string,charset(UTF16)] uint16 *form_name;
854 spoolss_FormSize size;
855 spoolss_FormArea area;
856 } spoolss_AddFormInfo1;
858 typedef [switch_type(uint32)] union {
859 [case(1)] spoolss_AddFormInfo1 *info1;
860 } spoolss_AddFormInfo;
862 WERROR spoolss_AddForm(
863 [in,ref] policy_handle *handle,
865 [in,switch_is(level)] spoolss_AddFormInfo info
870 WERROR spoolss_DeleteForm(
871 [in,ref] policy_handle *handle,
872 [in] [string,charset(UTF16)] uint16 form_name[]
877 WERROR spoolss_GetForm(
878 [in,ref] policy_handle *handle,
879 [in] [string,charset(UTF16)] uint16 form_name[],
881 [in,unique] DATA_BLOB *buffer,
883 [out,unique,subcontext(4),subcontext_size(offered),switch_is(level)] spoolss_FormInfo *info,
889 WERROR spoolss_SetForm(
890 [in,ref] policy_handle *handle,
891 [in] [string,charset(UTF16)] uint16 form_name[],
893 [in,switch_is(level)] spoolss_AddFormInfo info
898 [public,noopnum,noprint] WERROR _spoolss_EnumForms(
899 [in,ref] policy_handle *handle,
901 [in,unique] DATA_BLOB *buffer,
903 [out,unique] DATA_BLOB *info,
907 [public,noopnum,noprint] void __spoolss_EnumForms(
910 [out,switch_is(level)] spoolss_FormInfo info[count]
912 [nopull,nopush] WERROR spoolss_EnumForms(
913 [in,ref] policy_handle *handle,
915 [in,unique] DATA_BLOB *buffer,
917 [out,unique,switch_is(level),size_is(count)] spoolss_FormInfo *info,
923 [relative] nstring *port_name;
927 SPOOLSS_PORT_TYPE_WRITE = 0x00000001,
928 SPOOLSS_PORT_TYPE_READ = 0x00000002,
929 SPOOLSS_PORT_TYPE_REDIRECTED = 0x00000004,
930 SPOOLSS_PORT_TYPE_NET_ATTACHED = 0x00000008
934 [relative] nstring *port_name;
935 [relative] nstring *monitor_name;
936 [relative] nstring *description;
937 spoolss_PortType port_type;
941 typedef [nodiscriminant,relative_base,public] union {
942 [case(1)] spoolss_PortInfo1 info1;
943 [case(2)] spoolss_PortInfo2 info2;
944 [case(3)]; /* TODO */
950 [public,noopnum,noprint] WERROR _spoolss_EnumPorts(
951 [in,unique] [string,charset(UTF16)] uint16 *servername,
953 [in,unique] DATA_BLOB *buffer,
955 [out,unique] DATA_BLOB *info,
959 [public,noopnum,noprint] void __spoolss_EnumPorts(
962 [out,switch_is(level)] spoolss_PortInfo info[count]
964 [nopull,nopush] WERROR spoolss_EnumPorts(
965 [in,unique] [string,charset(UTF16)] uint16 *servername,
967 [in,unique] DATA_BLOB *buffer,
969 [out,unique,switch_is(level),size_is(count)] spoolss_PortInfo *info,
977 [relative] nstring *monitor_name;
978 } spoolss_MonitorInfo1;
981 [relative] nstring *monitor_name;
982 [relative] nstring *environment;
983 [relative] nstring *dll_name;
984 } spoolss_MonitorInfo2;
986 typedef [nodiscriminant,relative_base,public] union {
987 [case(1)] spoolss_MonitorInfo1 info1;
988 [case(2)] spoolss_MonitorInfo2 info2;
990 } spoolss_MonitorInfo;
992 [public,noopnum,noprint] WERROR _spoolss_EnumMonitors(
993 [in,unique] [string,charset(UTF16)] uint16 *servername,
995 [in,unique] DATA_BLOB *buffer,
997 [out,unique] DATA_BLOB *info,
1001 [public,noopnum,noprint] void __spoolss_EnumMonitors(
1004 [out,switch_is(level)] spoolss_MonitorInfo info[count]
1006 [nopull,nopush] WERROR spoolss_EnumMonitors(
1007 [in,unique] [string,charset(UTF16)] uint16 *servername,
1009 [in,unique] DATA_BLOB *buffer,
1010 [in] uint32 offered,
1011 [out,unique,switch_is(level),size_is(count)] spoolss_MonitorInfo *info,
1012 [out] uint32 needed,
1016 /******************/
1017 /* Function: 0x25 */
1018 WERROR spoolss_AddPort(
1019 [in,unique] [string,charset(UTF16)] uint16 *server_name,
1020 [in] uint32 unknown,
1021 [in] [string,charset(UTF16)] uint16 monitor_name[]
1024 /******************/
1025 /* Function: 0x26 */
1026 [todo] WERROR spoolss_ConfigurePort(
1029 /******************/
1030 /* Function: 0x27 */
1031 [todo] WERROR spoolss_DeletePort(
1034 /******************/
1035 /* Function: 0x28 */
1036 [todo] WERROR spoolss_CreatePrinterIC(
1039 /******************/
1040 /* Function: 0x29 */
1041 [todo] WERROR spoolss_PlayGDIScriptOnPrinterIC(
1044 /******************/
1045 /* Function: 0x2a */
1046 [todo] WERROR spoolss_DeletePrinterIC(
1049 /******************/
1050 /* Function: 0x2b */
1051 [todo] WERROR spoolss_AddPrinterConnection(
1054 /******************/
1055 /* Function: 0x2c */
1056 [todo] WERROR spoolss_DeletePrinterConnection(
1059 /******************/
1060 /* Function: 0x2d */
1061 [todo] WERROR spoolss_PrinterMessageBox(
1062 /* Marked as obsolete in MSDN. "Not necessary and has
1066 /******************/
1067 /* Function: 0x2e */
1068 [todo] WERROR spoolss_AddMonitor(
1071 /******************/
1072 /* Function: 0x2f */
1073 [todo] WERROR spoolss_DeleteMonitor(
1076 /******************/
1077 /* Function: 0x30 */
1078 [todo] WERROR spoolss_DeletePrintProcessor(
1081 /******************/
1082 /* Function: 0x31 */
1083 [todo] WERROR spoolss_AddPrintProvidor(
1086 /******************/
1087 /* Function: 0x32 */
1088 [todo] WERROR spoolss_DeletePrintProvidor(
1091 /******************/
1092 /* Function: 0x33 */
1093 [todo] WERROR spoolss_EnumPrintProcDataTypes(
1096 /******************/
1097 /* Function: 0x34 */
1098 [todo] WERROR spoolss_ResetPrinter(
1101 /******************/
1102 /* Function: 0x35 */
1103 WERROR spoolss_GetPrinterDriver2(
1104 [in,ref] policy_handle *handle,
1105 [in,unique] [string,charset(UTF16)] uint16 *architecture,
1107 [in,unique] DATA_BLOB *buffer,
1108 [in] uint32 offered,
1109 [in] uint32 client_major_version,
1110 [in] uint32 client_minor_version,
1111 [out,unique] DATA_BLOB *info,
1112 [out] uint32 needed,
1113 [out] uint32 server_major_version,
1114 [out] uint32 server_minor_version
1117 /******************/
1118 /* Function: 0x36 */
1119 [todo] WERROR spoolss_FindFirstPrinterChangeNotification(
1122 /******************/
1123 /* Function: 0x37 */
1124 [todo] WERROR spoolss_FindNextPrinterChangeNotification(
1127 /******************/
1128 /* Function: 0x38 */
1129 [public] WERROR spoolss_FindClosePrinterNotify(
1130 [in,ref] policy_handle *handle
1133 /******************/
1134 /* Function: 0x39 */
1135 [todo] WERROR spoolss_RouterFindFirstPrinterChangeNotificationOld(
1138 /******************/
1139 /* Function: 0x3a */
1140 [public] WERROR spoolss_ReplyOpenPrinter(
1141 [in,string,charset(UTF16)] uint16 server_name[],
1142 [in] uint32 printer_local,
1143 [in] winreg_Type type,
1144 [in] uint32 unknown1,
1145 [in] uint32 unknown2,
1146 [out,ref] policy_handle *handle
1149 /******************/
1150 /* Function: 0x3b */
1151 [todo] WERROR spoolss_RouterReplyPrinter(
1154 /******************/
1155 /* Function: 0x3c */
1156 [public] WERROR spoolss_ReplyClosePrinter(
1157 [in,out,ref] policy_handle *handle
1160 /******************/
1161 /* Function: 0x3d */
1162 [todo] WERROR spoolss_AddPortEx(
1165 /******************/
1166 /* Function: 0x3e */
1167 [todo] WERROR spoolss_RouterFindFirstPrinterChangeNotification(
1170 /******************/
1171 /* Function: 0x3f */
1172 [todo] WERROR spoolss_SpoolerInit(
1175 /******************/
1176 /* Function: 0x40 */
1177 [todo] WERROR spoolss_ResetPrinterEx(
1180 typedef [enum16bit] enum {
1181 SPOOLSS_FIELD_SERVER_NAME = 0,
1182 SPOOLSS_FIELD_PRINTER_NAME = 1,
1183 SPOOLSS_FIELD_SHARE_NAME = 2,
1184 SPOOLSS_FIELD_PORT_NAME = 3,
1185 SPOOLSS_FIELD_DRIVER_NAME = 4,
1186 SPOOLSS_FIELD_COMMENT = 5,
1187 SPOOLSS_FIELD_LOCATION = 6,
1188 SPOOLSS_FIELD_DEVMODE = 7,
1189 SPOOLSS_FIELD_SEPFILE = 8,
1190 SPOOLSS_FIELD_PRINT_PROCESSOR = 9,
1191 SPOOLSS_FIELD_PARAMETERS = 10,
1192 SPOOLSS_FIELD_DATATYPE = 11,
1193 SPOOLSS_FIELD_SECURITY_DESCRIPTOR=12,
1194 SPOOLSS_FIELD_ATTRIBUTES = 13,
1195 SPOOLSS_FIELD_PRIORITY = 14,
1196 SPOOLSS_FIELD_DEFAULT_PRIORITY = 15,
1197 SPOOLSS_FIELD_START_TIME = 16,
1198 SPOOLSS_FIELD_UNTIL_TIME = 17,
1199 SPOOLSS_FIELD_STATUS = 18,
1200 SPOOLSS_FIELD_STATUS_STRING = 19,
1201 SPOOLSS_FIELD_CJOBS = 20,
1202 SPOOLSS_FIELD_AVERAGE_PPM = 21,
1203 SPOOLSS_FIELD_TOTAL_PAGES = 22,
1204 SPOOLSS_FIELD_PAGES_PRINTED = 23,
1205 SPOOLSS_FIELD_TOTAL_BYTES = 24,
1206 SPOOLSS_FIELD_BYTES_PRINTED = 25
1209 typedef [enum16bit] enum {
1210 SPOOLSS_NOTIFY_PRINTER = 0,
1211 SPOOLSS_NOTIFY_JOB = 1
1212 } spoolss_NotifyType;
1214 /******************/
1215 /* Function: 0x41 */
1217 spoolss_NotifyType type;
1222 [size_is(count)] spoolss_Field *fields;
1223 } spoolss_NotifyOptionsArray;
1229 [size_is(count)] spoolss_NotifyOptionsArray *options;
1230 } spoolss_NotifyOptionsContainer;
1232 [public] WERROR spoolss_RemoteFindFirstPrinterChangeNotifyEx(
1233 [in,ref] policy_handle *handle,
1235 [in] uint32 options,
1236 [in,unique] [string,charset(UTF16)] uint16 *str,
1237 [in] uint32 printer_local,
1238 [in,unique] spoolss_NotifyOptionsContainer *t1
1241 /******************/
1242 /* Function: 0x42 */
1243 [todo] WERROR spoolss_RouterRefreshPrinterChangeNotification(
1248 [size_is(size/2),unique,charset(UTF16)] uint16 *string;
1249 } spoolss_NotifyUTF16String;
1253 [size_is(size),charset(DOS)] uint8 *string;
1254 } spoolss_NotifyDOSString;
1258 } spoolss_NotifyBlobData;
1262 [unique] spoolss_NotifyBlobData *data;
1263 } spoolss_NotifyBlob;
1265 typedef [switch_type(uint32)] union {
1266 [case(1)] dlong integer;
1267 [case(2)] spoolss_NotifyUTF16String utf16_string;
1268 [case(3)] spoolss_NotifyDOSString ascii_string;
1269 [case(4)] spoolss_NotifyBlob blob;
1270 [case(5)] spoolss_NotifyDOSString ascii_string;
1271 } spoolss_NotifyData;
1274 spoolss_NotifyType type;
1275 spoolss_Field field;
1276 uint32 variable_type;
1278 [switch_is(variable_type)] spoolss_NotifyData data;
1285 [size_is(count)] spoolss_Notify notifies[];
1286 } spoolss_NotifyInfo;
1288 /******************/
1289 /* Function: 0x43 */
1290 [public] WERROR spoolss_RemoteFindNextPrinterChangeNotifyEx(
1291 [in,ref] policy_handle *handle,
1292 [in] uint32 change_low,
1293 [in,unique] spoolss_NotifyOptionsContainer *container,
1294 [out,ref] spoolss_NotifyInfo **info
1297 /******************/
1298 /* Function: 0x44 */
1299 [todo] WERROR spoolss_44(
1304 [string,charset(UTF16)] uint16 *client;
1305 [string,charset(UTF16)] uint16 *user;
1310 } spoolss_UserLevel1;
1313 [case(1)] spoolss_UserLevel1 *level1;
1314 } spoolss_UserLevel;
1317 SERVER_ACCESS_ADMINISTER = 0x00000001,
1318 SERVER_ACCESS_ENUMERATE = 0x00000002,
1319 PRINTER_ACCESS_ADMINISTER = 0x00000004,
1320 PRINTER_ACCESS_USE = 0x00000008,
1321 JOB_ACCESS_ADMINISTER = 0x00000010
1322 } spoolss_AccessRights;
1324 /* Access rights for print servers */
1325 const int SERVER_ALL_ACCESS = SEC_STD_REQUIRED |
1326 SERVER_ACCESS_ADMINISTER |
1327 SERVER_ACCESS_ENUMERATE;
1329 const int SERVER_READ = SEC_STD_READ_CONTROL |
1330 SERVER_ACCESS_ENUMERATE;
1332 const int SERVER_WRITE = STANDARD_RIGHTS_WRITE_ACCESS |
1333 SERVER_ACCESS_ADMINISTER |
1334 SERVER_ACCESS_ENUMERATE;
1336 const int SERVER_EXECUTE = SEC_STD_READ_CONTROL |
1337 SERVER_ACCESS_ENUMERATE;
1339 /* Access rights for printers */
1340 const int PRINTER_ALL_ACCESS = SEC_STD_REQUIRED |
1341 PRINTER_ACCESS_ADMINISTER |
1344 const int PRINTER_READ = SEC_STD_READ_CONTROL |
1347 const int PRINTER_WRITE = STANDARD_RIGHTS_WRITE_ACCESS |
1350 const int PRINTER_EXECUTE = SEC_STD_READ_CONTROL |
1353 /* Access rights for jobs */
1354 const int JOB_ALL_ACCESS = SEC_STD_REQUIRED |
1355 JOB_ACCESS_ADMINISTER;
1357 const int JOB_READ = SEC_STD_READ_CONTROL |
1358 JOB_ACCESS_ADMINISTER;
1360 const int JOB_WRITE = STANDARD_RIGHTS_WRITE_ACCESS |
1361 JOB_ACCESS_ADMINISTER;
1363 const int JOB_EXECUTE = SEC_STD_READ_CONTROL |
1364 JOB_ACCESS_ADMINISTER;
1366 /* ACE masks for various print permissions */
1367 const int PRINTER_ACE_FULL_CONTROL = SEC_GENERIC_ALL |
1370 const int PRINTER_ACE_MANAGE_DOCUMENTS = SEC_GENERIC_ALL |
1371 READ_CONTROL_ACCESS;
1373 const int PRINTER_ACE_PRINT = GENERIC_EXECUTE_ACCESS |
1374 READ_CONTROL_ACCESS |
1377 /******************/
1378 /* Function: 0x45 */
1379 [public] WERROR spoolss_OpenPrinterEx(
1380 [in,unique] [string,charset(UTF16)] uint16 *printername,
1381 [in,unique] [string,charset(UTF16)] uint16 *datatype,
1382 [in] spoolss_DevmodeContainer devmode_ctr,
1383 [in] uint32 access_mask,
1385 [in,switch_is(level)] spoolss_UserLevel userlevel,
1386 [out,ref] policy_handle *handle
1389 /******************/
1390 /* Function: 0x46 */
1391 WERROR spoolss_AddPrinterEx(
1392 [in,unique] [string,charset(UTF16)] uint16 *server,
1394 [in,unique,switch_is(level)] spoolss_PrinterInfo *info,
1395 [in] spoolss_DevmodeContainer devmode_ctr,
1396 [in,unique] security_descriptor *secdesc,
1398 [in,switch_is(ulevel)] spoolss_UserLevel userlevel
1401 /******************/
1402 /* Function: 0x47 */
1403 [todo] WERROR spoolss_47(
1406 /******************/
1407 /* Function: 0x48 */
1408 WERROR spoolss_EnumPrinterData(
1409 [in,ref] policy_handle *handle,
1410 [in] uint32 enum_index,
1411 [out,ref,size_is(value_offered/2),charset(UTF16)] uint16 *value_name,
1412 [in] uint32 value_offered,
1413 [out,ref] uint32 *value_needed,
1414 [out,ref] uint32 *printerdata_type,
1415 [out,ref] DATA_BLOB *buffer,
1416 [in] uint32 data_offered,
1417 [out,ref] uint32 *data_needed
1420 /******************/
1421 /* Function: 0x49 */
1422 WERROR spoolss_DeletePrinterData(
1423 [in,ref] policy_handle *handle,
1424 [in] [string,charset(UTF16)] uint16 value_name[]
1427 /******************/
1428 /* Function: 0x4a */
1429 [todo] WERROR spoolss_4a(
1432 /******************/
1433 /* Function: 0x4b */
1434 [todo] WERROR spoolss_4b(
1437 /******************/
1438 /* Function: 0x4c */
1439 [todo] WERROR spoolss_4c(
1442 /******************/
1443 /* Function: 0x4d */
1444 WERROR spoolss_SetPrinterDataEx(
1445 [in,ref] policy_handle *handle,
1446 [in] [string,charset(UTF16)] uint16 key_name[],
1447 [in] [string,charset(UTF16)] uint16 value_name[],
1449 [in] DATA_BLOB buffer,
1453 /******************/
1454 /* Function: 0x4e */
1455 WERROR spoolss_GetPrinterDataEx(
1456 [in,ref] policy_handle *handle,
1457 [in] [string,charset(UTF16)] uint16 key_name[],
1458 [in] [string,charset(UTF16)] uint16 value_name[],
1459 [in] uint32 offered,
1461 [out] DATA_BLOB buffer,
1465 /******************/
1466 /* Function: 0x4f */
1467 [public] WERROR spoolss_EnumPrinterDataEx(
1468 [in,ref] policy_handle *handle,
1469 [in] [string,charset(UTF16)] uint16 key_name[],
1470 [in] uint32 offered,
1471 [out] DATA_BLOB buffer,
1472 [out] uint32 needed,
1476 /******************/
1477 /* Function: 0x50 */
1478 [public] WERROR spoolss_EnumPrinterKey(
1479 [in, ref] policy_handle *handle,
1480 [in] [string,charset(UTF16)] uint16 key_name[],
1481 [out] uint32 key_buffer_size,
1482 [out] uint16 key_buffer[key_buffer_size],
1483 [in,out] uint32 needed
1486 /******************/
1487 /* Function: 0x51 */
1488 WERROR spoolss_DeletePrinterDataEx(
1489 [in,ref] policy_handle *handle,
1490 [in] [string,charset(UTF16)] uint16 key_name[],
1491 [in] [string,charset(UTF16)] uint16 value_name[]
1494 /******************/
1495 /* Function: 0x52 */
1496 [todo] WERROR spoolss_DeletePrinterKey(
1499 /******************/
1500 /* Function: 0x53 */
1501 [todo] WERROR spoolss_53(
1504 /******************/
1505 /* Function: 0x54 */
1506 [todo] WERROR spoolss_DeletePrinterDriverEx(
1509 /******************/
1510 /* Function: 0x55 */
1511 [todo] WERROR spoolss_55(
1514 /******************/
1515 /* Function: 0x56 */
1516 [todo] WERROR spoolss_56(
1519 /******************/
1520 /* Function: 0x57 */
1521 [todo] WERROR spoolss_57(
1524 /******************/
1525 /* Function: 0x58 */
1526 WERROR spoolss_XcvData(
1527 [in,ref] policy_handle *handle,
1528 [in] [string,charset(UTF16)] uint16 function_name[],
1529 [in] DATA_BLOB in_data,
1530 [in,value(r->in.in_data.length)] uint32 _in_data_length,
1531 [in] uint32 offered,
1532 [in] uint32 unknown1,
1533 [out] DATA_BLOB out_data,
1534 [out] uint32 needed,
1535 [out] uint32 unknown2
1538 /******************/
1539 /* Function: 0x59 */
1540 [public,todo] WERROR spoolss_AddPrinterDriverEx(
1543 /******************/
1544 /* Function: 0x5a */
1545 [todo] WERROR spoolss_5a(
1548 /******************/
1549 /* Function: 0x5b */
1550 [todo] WERROR spoolss_5b(
1553 /******************/
1554 /* Function: 0x5c */
1555 [todo] WERROR spoolss_5c(
1558 /******************/
1559 /* Function: 0x5d */
1560 [todo] WERROR spoolss_5d(
1563 /******************/
1564 /* Function: 0x5e */
1565 [todo] WERROR spoolss_5e(
1568 /******************/
1569 /* Function: 0x5f */
1570 [todo] WERROR spoolss_5f(