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 [todo] WERROR spoolss_DeletePrinter(
401 typedef [v1_enum] enum {
402 SPOOLSS_PRINTER_CONTROL_UNPAUSE = 0,
403 SPOOLSS_PRINTER_CONTROL_PAUSE = 1,
404 SPOOLSS_PRINTER_CONTROL_RESUME = 2,
405 SPOOLSS_PRINTER_CONTROL_PURGE = 3,
406 SPOOLSS_PRINTER_CONTROL_SET_STATUS = 4
407 } spoolss_PrinterControl;
409 typedef [switch_type(uint32)] union {
410 [case(0)] spoolss_PrinterInfo0 *info0;
411 [case(1)] spoolss_PrinterInfo1 *info1;
412 [case(2)] spoolss_PrinterInfo2 *info2;
413 [case(3)] spoolss_PrinterInfo3 *info3;
414 [case(4)] spoolss_PrinterInfo4 *info4;
415 [case(5)] spoolss_PrinterInfo5 *info5;
416 [case(6)] spoolss_PrinterInfo6 *info6;
417 [case(7)] spoolss_PrinterInfo7 *info7;
418 [case(8)] spoolss_DeviceModeInfo *info8;
419 [case(9)] spoolss_DeviceModeInfo *info9;
421 } spoolss_SetPrinterInfo;
423 WERROR spoolss_SetPrinter(
424 [in,ref] policy_handle *handle,
426 [in,switch_is(level)] spoolss_SetPrinterInfo info,
427 [in] spoolss_DevmodeContainer devmode_ctr,
428 [in] sec_desc_buf secdesc_ctr,
429 [in] spoolss_PrinterControl command
434 [public] WERROR spoolss_GetPrinter(
435 [in,ref] policy_handle *handle,
437 [in,unique] DATA_BLOB *buffer,
439 [out,unique,subcontext(4),subcontext_size(offered),switch_is(level)] spoolss_PrinterInfo *info,
445 [todo] WERROR spoolss_AddPrinterDriver(
449 [relative] nstring *driver_name;
450 } spoolss_DriverInfo1;
452 typedef [v1_enum] enum {
453 SPOOLSS_DRIVER_VERSION_9X = 0,
454 SPOOLSS_DRIVER_VERSION_NT35 = 1,
455 SPOOLSS_DRIVER_VERSION_NT4 = 2,
456 SPOOLSS_DRIVER_VERSION_200X = 3
457 } spoolss_DriverOSVersion;
460 spoolss_DriverOSVersion version;
461 [relative] nstring *driver_name;
462 [relative] nstring *architecture;
463 [relative] nstring *driver_path;
464 [relative] nstring *data_file;
465 [relative] nstring *config_file;
466 } spoolss_DriverInfo2;
469 spoolss_DriverOSVersion version;
470 [relative] nstring *driver_name;
471 [relative] nstring *architecture;
472 [relative] nstring *driver_path;
473 [relative] nstring *data_file;
474 [relative] nstring *config_file;
475 [relative] nstring *help_file;
476 [relative] nstring_array *dependent_files;
477 [relative] nstring *monitor_name;
478 [relative] nstring *default_datatype;
479 } spoolss_DriverInfo3;
482 spoolss_DriverOSVersion version;
483 [relative] nstring *driver_name;
484 [relative] nstring *architecture;
485 [relative] nstring *driver_path;
486 [relative] nstring *data_file;
487 [relative] nstring *config_file;
488 [relative] nstring *help_file;
489 [relative] nstring_array *dependent_files;
490 [relative] nstring *monitor_name;
491 [relative] nstring *default_datatype;
492 [relative] nstring_array *previous_names;
493 } spoolss_DriverInfo4;
496 spoolss_DriverOSVersion version;
497 [relative] nstring *driver_name;
498 [relative] nstring *architecture;
499 [relative] nstring *driver_path;
500 [relative] nstring *data_file;
501 [relative] nstring *config_file;
502 uint32 driver_attributes;
503 uint32 config_version;
504 uint32 driver_version;
505 } spoolss_DriverInfo5;
508 spoolss_DriverOSVersion version;
509 [relative] nstring *driver_name;
510 [relative] nstring *architecture;
511 [relative] nstring *driver_path;
512 [relative] nstring *data_file;
513 [relative] nstring *config_file;
514 [relative] nstring *help_file;
515 [relative] nstring_array *dependent_files;
516 [relative] nstring *monitor_name;
517 [relative] nstring *default_datatype;
518 [relative] nstring_array *previous_names;
520 hyper driver_version;
521 [relative] nstring *manufacturer_name;
522 [relative] nstring *manufacturer_url;
523 [relative] nstring *hardware_id;
524 [relative] nstring *provider;
525 } spoolss_DriverInfo6;
527 typedef [nodiscriminant,relative_base,public] union {
528 [case(1)] spoolss_DriverInfo1 info1;
529 [case(2)] spoolss_DriverInfo2 info2;
530 [case(3)] spoolss_DriverInfo3 info3;
531 [case(4)] spoolss_DriverInfo4 info4;
532 [case(5)] spoolss_DriverInfo5 info5;
533 [case(6)] spoolss_DriverInfo6 info6;
535 } spoolss_DriverInfo;
539 [public,noopnum,noprint] WERROR _spoolss_EnumPrinterDrivers(
540 [in,unique] [string,charset(UTF16)] uint16 *server,
541 [in,unique] [string,charset(UTF16)] uint16 *environment,
543 [in,unique] DATA_BLOB *buffer,
545 [out,unique] DATA_BLOB *info,
549 [public,noopnum,noprint] void __spoolss_EnumPrinterDrivers(
552 [out,switch_is(level)] spoolss_DriverInfo info[count]
554 [nopull,nopush] WERROR spoolss_EnumPrinterDrivers(
555 [in,unique] [string,charset(UTF16)] uint16 *server,
556 [in,unique] [string,charset(UTF16)] uint16 *environment,
558 [in,unique] DATA_BLOB *buffer,
560 [out,unique,switch_is(level),size_is(count)] spoolss_DriverInfo *info,
567 [todo] WERROR spoolss_GetPrinterDriver(
573 nstring directory_name;
574 } spoolss_DriverDirectoryInfo1;
576 /* NOTE: it's seems that w2k3 completly ignores the level
579 typedef [nodiscriminant,relative_base,gensize,public] union {
580 [case(1)] spoolss_DriverDirectoryInfo1 info1;
581 [default] spoolss_DriverDirectoryInfo1 info1;
582 } spoolss_DriverDirectoryInfo;
584 [public] WERROR spoolss_GetPrinterDriverDirectory(
585 [in,unique] [string,charset(UTF16)] uint16 *server,
586 [in,unique] [string,charset(UTF16)] uint16 *environment,
588 [in,unique] DATA_BLOB *buffer,
590 [out,unique,subcontext(4),subcontext_size(offered),switch_is(level)] spoolss_DriverDirectoryInfo *info,
596 WERROR spoolss_DeletePrinterDriver(
597 [in,ref] policy_handle *handle,
598 [in,unique] [string,charset(UTF16)] uint16 *server,
599 [in] [string,charset(UTF16)] uint16 architecture[],
600 [in] [string,charset(UTF16)] uint16 driver[]
605 [todo] WERROR spoolss_AddPrintProcessor(
611 [relative] nstring *print_processor_name;
612 } spoolss_PrintProcessorInfo1;
614 typedef [nodiscriminant,relative_base,public] union {
615 [case(1)] spoolss_PrintProcessorInfo1 info1;
617 } spoolss_PrintProcessorInfo;
619 [public,noopnum,noprint] WERROR _spoolss_EnumPrintProcessors(
620 [in,unique] [string,charset(UTF16)] uint16 *servername,
621 [in,unique] [string,charset(UTF16)] uint16 *environment,
623 [in,unique] DATA_BLOB *buffer,
625 [out,unique] DATA_BLOB *info,
629 [public,noopnum,noprint] void __spoolss_EnumPrintProcessors(
632 [out,switch_is(level)] spoolss_PrintProcessorInfo info[count]
634 [nopull,nopush] WERROR spoolss_EnumPrintProcessors(
635 [in,unique] [string,charset(UTF16)] uint16 *servername,
636 [in,unique] [string,charset(UTF16)] uint16 *environment,
638 [in,unique] DATA_BLOB *buffer,
640 [out,unique,switch_is(level),size_is(count)] spoolss_PrintProcessorInfo *info,
647 [todo] WERROR spoolss_GetPrintProcessorDirectory(
653 [string,charset(UTF16)] uint16 *document_name;
654 [string,charset(UTF16)] uint16 *output_file;
655 [string,charset(UTF16)] uint16 *datatype;
656 } spoolss_DocumentInfo1;
658 typedef [switch_type(uint32)] union {
659 [case(1)] spoolss_DocumentInfo1 *info1;
660 [case(2)]; /* TODO */
661 [case(3)]; /* TODO */
663 } spoolss_DocumentInfo;
665 WERROR spoolss_StartDocPrinter(
666 [in,ref] policy_handle *handle,
668 [in,switch_is(level)] spoolss_DocumentInfo info,
674 WERROR spoolss_StartPagePrinter(
675 [in,ref] policy_handle *handle
680 WERROR spoolss_WritePrinter(
681 [in,ref] policy_handle *handle,
683 [in,value(r->in.data.length)] uint32 _data_size,
684 [out] uint32 num_written
689 WERROR spoolss_EndPagePrinter(
690 [in,ref] policy_handle *handle
695 WERROR spoolss_AbortPrinter(
696 [in,ref] policy_handle *handle
701 WERROR spoolss_ReadPrinter(
702 [in,ref] policy_handle *handle,
703 [in] uint32 data_size,
704 [out] DATA_BLOB data,
705 [out,value(r->out.data.length)] uint32 _data_size
710 WERROR spoolss_EndDocPrinter(
711 [in,ref] policy_handle *handle
716 [todo] WERROR spoolss_AddJob(
721 [todo] WERROR spoolss_ScheduleJob(
726 const string SPOOLSS_ARCHITECTURE_NT_X86 = "Windows NT x86";
728 typedef [public,gensize] struct {
729 [value(ndr_size_spoolss_OSVersion(r,ndr->iconv_convenience,ndr->flags))] uint32 _ndr_size;
733 [value(2)] uint32 unknown;
734 [subcontext(0),subcontext_size(256)] nstring extra_string;
737 typedef [public,gensize] struct {
738 [value(ndr_size_spoolss_OSVersionEx(r,ndr->iconv_convenience,ndr->flags))] uint32 _ndr_size;
742 [value(2)] uint32 unknown1;
743 [subcontext(0),subcontext_size(256)] nstring extra_string;
744 uint32 unknown2;/* service pack number? I saw 0 from w2k3 and 1 from winxp sp1*/
745 uint32 unknown3;/* hmm? w2k3: 131346(0x20112) winxp sp1: 503382272 0x1E010100 */
746 } spoolss_OSVersionEx;
748 typedef [v1_enum] enum {
749 SPOOLSS_PRINTER_DATA_TYPE_NULL = 0,
750 SPOOLSS_PRINTER_DATA_TYPE_STRING = 1,
751 SPOOLSS_PRINTER_DATA_TYPE_BINARY = 3,
752 SPOOLSS_PRINTER_DATA_TYPE_UINT32 = 4,
753 SPOOLSS_PRINTER_DATA_TYPE_STRING_ARRAY = 7
754 } spoolss_PrinterDataType;
756 typedef [nodiscriminant,public,gensize] union {
757 [case(SPOOLSS_PRINTER_DATA_TYPE_NULL)];
758 [case(SPOOLSS_PRINTER_DATA_TYPE_STRING)] nstring string;
759 [case(SPOOLSS_PRINTER_DATA_TYPE_BINARY),flag(NDR_REMAINING)] DATA_BLOB binary;
760 [case(SPOOLSS_PRINTER_DATA_TYPE_UINT32)] uint32 value;
761 [case(SPOOLSS_PRINTER_DATA_TYPE_STRING_ARRAY)] nstring_array string_array;
762 [default,flag(NDR_REMAINING)] DATA_BLOB data;
763 } spoolss_PrinterData;
765 [noopnum,noprint,public] WERROR _spoolss_GetPrinterData(
766 [in,ref] policy_handle *handle,
767 [in] [string,charset(UTF16)] uint16 value_name[],
769 [out] spoolss_PrinterDataType type,
770 [out] DATA_BLOB data,
773 [noopnum,noprint,public] void __spoolss_GetPrinterData(
774 [in] spoolss_PrinterDataType type,
775 [out,switch_is(type)] spoolss_PrinterData data
777 [nopull,nopush,public] WERROR spoolss_GetPrinterData(
778 [in,ref] policy_handle *handle,
779 [in] [string,charset(UTF16)] uint16 value_name[],
781 [out] spoolss_PrinterDataType type,
782 [out,subcontext(4),subcontext_size(offered),switch_is(type)] spoolss_PrinterData data,
788 [noopnum,nopull,noprint,public] WERROR _spoolss_SetPrinterData(
789 [in,ref] policy_handle *handle,
790 [in] [string,charset(UTF16)] uint16 value_name[],
791 [in] spoolss_PrinterDataType type,
795 [noopnum,nopull,noprint,public] void __spoolss_SetPrinterData(
796 [in] spoolss_PrinterDataType type,
797 [out,switch_is(type)] spoolss_PrinterData data
799 [nopush] WERROR spoolss_SetPrinterData(
800 [in,ref] policy_handle *handle,
801 [in] [string,charset(UTF16)] uint16 value_name[],
802 [in] spoolss_PrinterDataType type,
803 [in,subcontext(4),switch_is(type)] spoolss_PrinterData data,
804 [in,value(ndr_size_spoolss_PrinterData(&data,type,ndr->iconv_convenience,flags))] uint32 _offered
809 [todo] WERROR spoolss_WaitForPrinterChange(
814 [public] WERROR spoolss_ClosePrinter(
815 [in,out,ref] policy_handle *handle
820 typedef [v1_enum] enum {
821 SPOOLSS_FORM_USER = 0,
822 SPOOLSS_FORM_BUILTIN = 1,
823 SPOOLSS_FORM_PRINTER = 2
839 spoolss_FormFlags flags;
840 [relative] nstring *form_name;
841 spoolss_FormSize size;
842 spoolss_FormArea area;
845 typedef [nodiscriminant,relative_base,public,gensize] union {
846 [case(1)] spoolss_FormInfo1 info1;
851 spoolss_FormFlags flags;
852 [string,charset(UTF16)] uint16 *form_name;
853 spoolss_FormSize size;
854 spoolss_FormArea area;
855 } spoolss_AddFormInfo1;
857 typedef [switch_type(uint32)] union {
858 [case(1)] spoolss_AddFormInfo1 *info1;
859 } spoolss_AddFormInfo;
861 WERROR spoolss_AddForm(
862 [in,ref] policy_handle *handle,
864 [in,switch_is(level)] spoolss_AddFormInfo info
869 WERROR spoolss_DeleteForm(
870 [in,ref] policy_handle *handle,
871 [in] [string,charset(UTF16)] uint16 form_name[]
876 WERROR spoolss_GetForm(
877 [in,ref] policy_handle *handle,
878 [in] [string,charset(UTF16)] uint16 form_name[],
880 [in,unique] DATA_BLOB *buffer,
882 [out,unique,subcontext(4),subcontext_size(offered),switch_is(level)] spoolss_FormInfo *info,
888 WERROR spoolss_SetForm(
889 [in,ref] policy_handle *handle,
890 [in] [string,charset(UTF16)] uint16 form_name[],
892 [in,switch_is(level)] spoolss_AddFormInfo info
897 [public,noopnum,noprint] WERROR _spoolss_EnumForms(
898 [in,ref] policy_handle *handle,
900 [in,unique] DATA_BLOB *buffer,
902 [out,unique] DATA_BLOB *info,
906 [public,noopnum,noprint] void __spoolss_EnumForms(
909 [out,switch_is(level)] spoolss_FormInfo info[count]
911 [nopull,nopush] WERROR spoolss_EnumForms(
912 [in,ref] policy_handle *handle,
914 [in,unique] DATA_BLOB *buffer,
916 [out,unique,switch_is(level),size_is(count)] spoolss_FormInfo *info,
922 [relative] nstring *port_name;
926 SPOOLSS_PORT_TYPE_WRITE = 0x00000001,
927 SPOOLSS_PORT_TYPE_READ = 0x00000002,
928 SPOOLSS_PORT_TYPE_REDIRECTED = 0x00000004,
929 SPOOLSS_PORT_TYPE_NET_ATTACHED = 0x00000008
933 [relative] nstring *port_name;
934 [relative] nstring *monitor_name;
935 [relative] nstring *description;
936 spoolss_PortType port_type;
940 typedef [nodiscriminant,relative_base,public] union {
941 [case(1)] spoolss_PortInfo1 info1;
942 [case(2)] spoolss_PortInfo2 info2;
943 [case(3)]; /* TODO */
949 [public,noopnum,noprint] WERROR _spoolss_EnumPorts(
950 [in,unique] [string,charset(UTF16)] uint16 *servername,
952 [in,unique] DATA_BLOB *buffer,
954 [out,unique] DATA_BLOB *info,
958 [public,noopnum,noprint] void __spoolss_EnumPorts(
961 [out,switch_is(level)] spoolss_PortInfo info[count]
963 [nopull,nopush] WERROR spoolss_EnumPorts(
964 [in,unique] [string,charset(UTF16)] uint16 *servername,
966 [in,unique] DATA_BLOB *buffer,
968 [out,unique,switch_is(level),size_is(count)] spoolss_PortInfo *info,
976 [relative] nstring *monitor_name;
977 } spoolss_MonitorInfo1;
980 [relative] nstring *monitor_name;
981 [relative] nstring *environment;
982 [relative] nstring *dll_name;
983 } spoolss_MonitorInfo2;
985 typedef [nodiscriminant,relative_base,public] union {
986 [case(1)] spoolss_MonitorInfo1 info1;
987 [case(2)] spoolss_MonitorInfo2 info2;
989 } spoolss_MonitorInfo;
991 [public,noopnum,noprint] WERROR _spoolss_EnumMonitors(
992 [in,unique] [string,charset(UTF16)] uint16 *servername,
994 [in,unique] DATA_BLOB *buffer,
996 [out,unique] DATA_BLOB *info,
1000 [public,noopnum,noprint] void __spoolss_EnumMonitors(
1003 [out,switch_is(level)] spoolss_MonitorInfo info[count]
1005 [nopull,nopush] WERROR spoolss_EnumMonitors(
1006 [in,unique] [string,charset(UTF16)] uint16 *servername,
1008 [in,unique] DATA_BLOB *buffer,
1009 [in] uint32 offered,
1010 [out,unique,switch_is(level),size_is(count)] spoolss_MonitorInfo *info,
1011 [out] uint32 needed,
1015 /******************/
1016 /* Function: 0x25 */
1017 WERROR spoolss_AddPort(
1018 [in,unique] [string,charset(UTF16)] uint16 *server_name,
1019 [in] uint32 unknown,
1020 [in] [string,charset(UTF16)] uint16 monitor_name[]
1023 /******************/
1024 /* Function: 0x26 */
1025 [todo] WERROR spoolss_ConfigurePort(
1028 /******************/
1029 /* Function: 0x27 */
1030 [todo] WERROR spoolss_DeletePort(
1033 /******************/
1034 /* Function: 0x28 */
1035 [todo] WERROR spoolss_CreatePrinterIC(
1038 /******************/
1039 /* Function: 0x29 */
1040 [todo] WERROR spoolss_PlayGDIScriptOnPrinterIC(
1043 /******************/
1044 /* Function: 0x2a */
1045 [todo] WERROR spoolss_DeletePrinterIC(
1048 /******************/
1049 /* Function: 0x2b */
1050 [todo] WERROR spoolss_AddPrinterConnection(
1053 /******************/
1054 /* Function: 0x2c */
1055 [todo] WERROR spoolss_DeletePrinterConnection(
1058 /******************/
1059 /* Function: 0x2d */
1060 [todo] WERROR spoolss_PrinterMessageBox(
1061 /* Marked as obsolete in MSDN. "Not necessary and has
1065 /******************/
1066 /* Function: 0x2e */
1067 [todo] WERROR spoolss_AddMonitor(
1070 /******************/
1071 /* Function: 0x2f */
1072 [todo] WERROR spoolss_DeleteMonitor(
1075 /******************/
1076 /* Function: 0x30 */
1077 [todo] WERROR spoolss_DeletePrintProcessor(
1080 /******************/
1081 /* Function: 0x31 */
1082 [todo] WERROR spoolss_AddPrintProvidor(
1085 /******************/
1086 /* Function: 0x32 */
1087 [todo] WERROR spoolss_DeletePrintProvidor(
1090 /******************/
1091 /* Function: 0x33 */
1092 [todo] WERROR spoolss_EnumPrintProcDataTypes(
1095 /******************/
1096 /* Function: 0x34 */
1097 [todo] WERROR spoolss_ResetPrinter(
1100 /******************/
1101 /* Function: 0x35 */
1102 WERROR spoolss_GetPrinterDriver2(
1103 [in,ref] policy_handle *handle,
1104 [in,unique] [string,charset(UTF16)] uint16 *architecture,
1106 [in,unique] DATA_BLOB *buffer,
1107 [in] uint32 offered,
1108 [in] uint32 client_major_version,
1109 [in] uint32 client_minor_version,
1110 [out,unique] DATA_BLOB *info,
1111 [out] uint32 needed,
1112 [out] uint32 server_major_version,
1113 [out] uint32 server_minor_version
1116 /******************/
1117 /* Function: 0x36 */
1118 [todo] WERROR spoolss_FindFirstPrinterChangeNotification(
1121 /******************/
1122 /* Function: 0x37 */
1123 [todo] WERROR spoolss_FindNextPrinterChangeNotification(
1126 /******************/
1127 /* Function: 0x38 */
1128 [public] WERROR spoolss_FindClosePrinterNotify(
1129 [in,ref] policy_handle *handle
1132 /******************/
1133 /* Function: 0x39 */
1134 [todo] WERROR spoolss_RouterFindFirstPrinterChangeNotificationOld(
1137 /******************/
1138 /* Function: 0x3a */
1139 [public] WERROR spoolss_ReplyOpenPrinter(
1140 [in,string,charset(UTF16)] uint16 server_name[],
1141 [in] uint32 printer_local,
1142 [in] winreg_Type type,
1143 [in] uint32 unknown1,
1144 [in] uint32 unknown2,
1145 [out,ref] policy_handle *handle
1148 /******************/
1149 /* Function: 0x3b */
1150 [todo] WERROR spoolss_RouterReplyPrinter(
1153 /******************/
1154 /* Function: 0x3c */
1155 [public] WERROR spoolss_ReplyClosePrinter(
1156 [in,out,ref] policy_handle *handle
1159 /******************/
1160 /* Function: 0x3d */
1161 [todo] WERROR spoolss_AddPortEx(
1164 /******************/
1165 /* Function: 0x3e */
1166 [todo] WERROR spoolss_RouterFindFirstPrinterChangeNotification(
1169 /******************/
1170 /* Function: 0x3f */
1171 [todo] WERROR spoolss_SpoolerInit(
1174 /******************/
1175 /* Function: 0x40 */
1176 [todo] WERROR spoolss_ResetPrinterEx(
1179 typedef [enum16bit] enum {
1180 SPOOLSS_FIELD_SERVER_NAME = 0,
1181 SPOOLSS_FIELD_PRINTER_NAME = 1,
1182 SPOOLSS_FIELD_SHARE_NAME = 2,
1183 SPOOLSS_FIELD_PORT_NAME = 3,
1184 SPOOLSS_FIELD_DRIVER_NAME = 4,
1185 SPOOLSS_FIELD_COMMENT = 5,
1186 SPOOLSS_FIELD_LOCATION = 6,
1187 SPOOLSS_FIELD_DEVMODE = 7,
1188 SPOOLSS_FIELD_SEPFILE = 8,
1189 SPOOLSS_FIELD_PRINT_PROCESSOR = 9,
1190 SPOOLSS_FIELD_PARAMETERS = 10,
1191 SPOOLSS_FIELD_DATATYPE = 11,
1192 SPOOLSS_FIELD_SECURITY_DESCRIPTOR=12,
1193 SPOOLSS_FIELD_ATTRIBUTES = 13,
1194 SPOOLSS_FIELD_PRIORITY = 14,
1195 SPOOLSS_FIELD_DEFAULT_PRIORITY = 15,
1196 SPOOLSS_FIELD_START_TIME = 16,
1197 SPOOLSS_FIELD_UNTIL_TIME = 17,
1198 SPOOLSS_FIELD_STATUS = 18,
1199 SPOOLSS_FIELD_STATUS_STRING = 19,
1200 SPOOLSS_FIELD_CJOBS = 20,
1201 SPOOLSS_FIELD_AVERAGE_PPM = 21,
1202 SPOOLSS_FIELD_TOTAL_PAGES = 22,
1203 SPOOLSS_FIELD_PAGES_PRINTED = 23,
1204 SPOOLSS_FIELD_TOTAL_BYTES = 24,
1205 SPOOLSS_FIELD_BYTES_PRINTED = 25
1208 typedef [enum16bit] enum {
1209 SPOOLSS_NOTIFY_PRINTER = 0,
1210 SPOOLSS_NOTIFY_JOB = 1
1211 } spoolss_NotifyType;
1213 /******************/
1214 /* Function: 0x41 */
1216 spoolss_NotifyType type;
1221 [size_is(count)] spoolss_Field *fields;
1222 } spoolss_NotifyOptionsArray;
1228 [size_is(count)] spoolss_NotifyOptionsArray *options;
1229 } spoolss_NotifyOptionsContainer;
1231 [public] WERROR spoolss_RemoteFindFirstPrinterChangeNotifyEx(
1232 [in,ref] policy_handle *handle,
1234 [in] uint32 options,
1235 [in,unique] [string,charset(UTF16)] uint16 *str,
1236 [in] uint32 printer_local,
1237 [in,unique] spoolss_NotifyOptionsContainer *t1
1240 /******************/
1241 /* Function: 0x42 */
1242 [todo] WERROR spoolss_RouterRefreshPrinterChangeNotification(
1247 [size_is(size/2),unique,charset(UTF16)] uint16 *string;
1248 } spoolss_NotifyUTF16String;
1252 [size_is(size),charset(DOS)] uint8 *string;
1253 } spoolss_NotifyDOSString;
1257 } spoolss_NotifyBlobData;
1261 [unique] spoolss_NotifyBlobData *data;
1262 } spoolss_NotifyBlob;
1264 typedef [switch_type(uint32)] union {
1265 [case(1)] dlong integer;
1266 [case(2)] spoolss_NotifyUTF16String utf16_string;
1267 [case(3)] spoolss_NotifyDOSString ascii_string;
1268 [case(4)] spoolss_NotifyBlob blob;
1269 [case(5)] spoolss_NotifyDOSString ascii_string;
1270 } spoolss_NotifyData;
1273 spoolss_NotifyType type;
1274 spoolss_Field field;
1275 uint32 variable_type;
1277 [switch_is(variable_type)] spoolss_NotifyData data;
1284 [size_is(count)] spoolss_Notify notifies[];
1285 } spoolss_NotifyInfo;
1287 /******************/
1288 /* Function: 0x43 */
1289 [public] WERROR spoolss_RemoteFindNextPrinterChangeNotifyEx(
1290 [in,ref] policy_handle *handle,
1291 [in] uint32 change_low,
1292 [in,unique] spoolss_NotifyOptionsContainer *container,
1293 [out, unique] spoolss_NotifyInfo *info
1296 /******************/
1297 /* Function: 0x44 */
1298 [todo] WERROR spoolss_44(
1303 [string,charset(UTF16)] uint16 *client;
1304 [string,charset(UTF16)] uint16 *user;
1309 } spoolss_UserLevel1;
1312 [case(1)] spoolss_UserLevel1 *level1;
1313 } spoolss_UserLevel;
1316 SERVER_ACCESS_ADMINISTER = 0x00000001,
1317 SERVER_ACCESS_ENUMERATE = 0x00000002,
1318 PRINTER_ACCESS_ADMINISTER = 0x00000004,
1319 PRINTER_ACCESS_USE = 0x00000008,
1320 JOB_ACCESS_ADMINISTER = 0x00000010
1321 } spoolss_AccessRights;
1323 /* Access rights for print servers */
1324 const int SERVER_ALL_ACCESS = SEC_STD_REQUIRED |
1325 SERVER_ACCESS_ADMINISTER |
1326 SERVER_ACCESS_ENUMERATE;
1328 const int SERVER_READ = SEC_STD_READ_CONTROL |
1329 SERVER_ACCESS_ENUMERATE;
1331 const int SERVER_WRITE = STANDARD_RIGHTS_WRITE_ACCESS |
1332 SERVER_ACCESS_ADMINISTER |
1333 SERVER_ACCESS_ENUMERATE;
1335 const int SERVER_EXECUTE = SEC_STD_READ_CONTROL |
1336 SERVER_ACCESS_ENUMERATE;
1338 /* Access rights for printers */
1339 const int PRINTER_ALL_ACCESS = SEC_STD_REQUIRED |
1340 PRINTER_ACCESS_ADMINISTER |
1343 const int PRINTER_READ = SEC_STD_READ_CONTROL |
1346 const int PRINTER_WRITE = STANDARD_RIGHTS_WRITE_ACCESS |
1349 const int PRINTER_EXECUTE = SEC_STD_READ_CONTROL |
1352 /* Access rights for jobs */
1353 const int JOB_ALL_ACCESS = SEC_STD_REQUIRED |
1354 JOB_ACCESS_ADMINISTER;
1356 const int JOB_READ = SEC_STD_READ_CONTROL |
1357 JOB_ACCESS_ADMINISTER;
1359 const int JOB_WRITE = STANDARD_RIGHTS_WRITE_ACCESS |
1360 JOB_ACCESS_ADMINISTER;
1362 const int JOB_EXECUTE = SEC_STD_READ_CONTROL |
1363 JOB_ACCESS_ADMINISTER;
1365 /* ACE masks for various print permissions */
1366 const int PRINTER_ACE_FULL_CONTROL = SEC_GENERIC_ALL |
1369 const int PRINTER_ACE_MANAGE_DOCUMENTS = SEC_GENERIC_ALL |
1370 READ_CONTROL_ACCESS;
1372 const int PRINTER_ACE_PRINT = GENERIC_EXECUTE_ACCESS |
1373 READ_CONTROL_ACCESS |
1376 /******************/
1377 /* Function: 0x45 */
1378 [public] WERROR spoolss_OpenPrinterEx(
1379 [in,unique] [string,charset(UTF16)] uint16 *printername,
1380 [in,unique] [string,charset(UTF16)] uint16 *datatype,
1381 [in] spoolss_DevmodeContainer devmode_ctr,
1382 [in] uint32 access_mask,
1384 [in,switch_is(level)] spoolss_UserLevel userlevel,
1385 [out,ref] policy_handle *handle
1388 /******************/
1389 /* Function: 0x46 */
1390 WERROR spoolss_AddPrinterEx(
1391 [in,unique] [string,charset(UTF16)] uint16 *server,
1393 [in,unique,switch_is(level)] spoolss_PrinterInfo *info,
1394 [in] spoolss_DevmodeContainer devmode_ctr,
1395 [in,unique] security_descriptor *secdesc,
1397 [in,switch_is(ulevel)] spoolss_UserLevel userlevel
1400 /******************/
1401 /* Function: 0x47 */
1402 [todo] WERROR spoolss_47(
1405 /******************/
1406 /* Function: 0x48 */
1407 WERROR spoolss_EnumPrinterData(
1408 [in,ref] policy_handle *handle,
1409 [in] uint32 enum_index,
1410 [out,ref,size_is(value_offered/2),charset(UTF16)] uint16 *value_name,
1411 [in] uint32 value_offered,
1412 [out,ref] uint32 *value_needed,
1413 [out,ref] uint32 *printerdata_type,
1414 [out,ref] DATA_BLOB *buffer,
1415 [in] uint32 data_offered,
1416 [out,ref] uint32 *data_needed
1419 /******************/
1420 /* Function: 0x49 */
1421 WERROR spoolss_DeletePrinterData(
1422 [in,ref] policy_handle *handle,
1423 [in] [string,charset(UTF16)] uint16 value_name[]
1426 /******************/
1427 /* Function: 0x4a */
1428 [todo] WERROR spoolss_4a(
1431 /******************/
1432 /* Function: 0x4b */
1433 [todo] WERROR spoolss_4b(
1436 /******************/
1437 /* Function: 0x4c */
1438 [todo] WERROR spoolss_4c(
1441 /******************/
1442 /* Function: 0x4d */
1443 WERROR spoolss_SetPrinterDataEx(
1444 [in,ref] policy_handle *handle,
1445 [in] [string,charset(UTF16)] uint16 key_name[],
1446 [in] [string,charset(UTF16)] uint16 value_name[],
1448 [in] DATA_BLOB buffer,
1452 /******************/
1453 /* Function: 0x4e */
1454 WERROR spoolss_GetPrinterDataEx(
1455 [in,ref] policy_handle *handle,
1456 [in] [string,charset(UTF16)] uint16 key_name[],
1457 [in] [string,charset(UTF16)] uint16 value_name[],
1458 [in] uint32 offered,
1460 [out] DATA_BLOB buffer,
1464 /******************/
1465 /* Function: 0x4f */
1466 [public] WERROR spoolss_EnumPrinterDataEx(
1467 [in,ref] policy_handle *handle,
1468 [in] [string,charset(UTF16)] uint16 key_name[],
1469 [in] uint32 offered,
1470 [out] DATA_BLOB buffer,
1471 [out] uint32 needed,
1475 /******************/
1476 /* Function: 0x50 */
1477 [public] WERROR spoolss_EnumPrinterKey(
1478 [in, ref] policy_handle *handle,
1479 [in] [string,charset(UTF16)] uint16 key_name[],
1480 [out] uint32 key_buffer_size,
1481 [out] uint16 key_buffer[key_buffer_size],
1482 [in,out] uint32 needed
1485 /******************/
1486 /* Function: 0x51 */
1487 WERROR spoolss_DeletePrinterDataEx(
1488 [in,ref] policy_handle *handle,
1489 [in] [string,charset(UTF16)] uint16 key_name[],
1490 [in] [string,charset(UTF16)] uint16 value_name[]
1493 /******************/
1494 /* Function: 0x52 */
1495 [todo] WERROR spoolss_DeletePrinterKey(
1498 /******************/
1499 /* Function: 0x53 */
1500 [todo] WERROR spoolss_53(
1503 /******************/
1504 /* Function: 0x54 */
1505 [todo] WERROR spoolss_DeletePrinterDriverEx(
1508 /******************/
1509 /* Function: 0x55 */
1510 [todo] WERROR spoolss_55(
1513 /******************/
1514 /* Function: 0x56 */
1515 [todo] WERROR spoolss_56(
1518 /******************/
1519 /* Function: 0x57 */
1520 [todo] WERROR spoolss_57(
1523 /******************/
1524 /* Function: 0x58 */
1525 WERROR spoolss_XcvData(
1526 [in,ref] policy_handle *handle,
1527 [in] [string,charset(UTF16)] uint16 function_name[],
1528 [in] DATA_BLOB in_data,
1529 [in,value(r->in.in_data.length)] uint32 _in_data_length,
1530 [in] uint32 offered,
1531 [in] uint32 unknown1,
1532 [out] DATA_BLOB out_data,
1533 [out] uint32 needed,
1534 [out] uint32 unknown2
1537 /******************/
1538 /* Function: 0x59 */
1539 [public,todo] WERROR spoolss_AddPrinterDriverEx(
1542 /******************/
1543 /* Function: 0x5a */
1544 [todo] WERROR spoolss_5a(
1547 /******************/
1548 /* Function: 0x5b */
1549 [todo] WERROR spoolss_5b(
1552 /******************/
1553 /* Function: 0x5c */
1554 [todo] WERROR spoolss_5c(
1557 /******************/
1558 /* Function: 0x5d */
1559 [todo] WERROR spoolss_5d(
1562 /******************/
1563 /* Function: 0x5e */
1564 [todo] WERROR spoolss_5e(
1567 /******************/
1568 /* Function: 0x5f */
1569 [todo] WERROR spoolss_5f(