Type: required
Title: Printer QueueInfo methods changing
Posted by: [EMAIL PROTECTED]
Affected: svtools, sw, toolkit
Effective from: CWS prdiscw
*Summary*
--------
-USHORT GetQueueCount();
-const QueueInfo& GetQueueInfo( USHORT nQueue );
-const QueueInfo& GetQueueInfo( USHORT nQueue, BOOL bStatus );
+const std::vector< rtl::OUString >& GetPrinterQueues();
+const QueueInfo* GetQueueInfo( const String& rPrinterName, bool bStatusUpdate
);
*Description*
-------------
The old method to enumerate printer queues was GetQueueCount and then
GetQueueInfo for every printer. This has the disadvantage that on
Windows GetQueueInfo needs to open a connection to the print server
for remote printers. That means to get the printer name list it was
necessary to open each and every network printer. Since every instance
found throughout the code did this just to get the names, the API
changed to get the list of print queues and get info for a specific
printer (which you need e.g. as soon as you select a printer in the
print dialog or the printer settings dialog).
Reminder: if GetQueueInfo gets called with status update, the printer
will be opened again to query the status, if called without status
update GetQueueInfo will open the printer only once and the return the
cached values.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
