IADsPrintQueue

The IADsPrintQueue interface represents a printer on a network. It is a dual interface that inherits from IADs. The property methods of this interface allow you to access data about a printer, for example printer model, physical location, and network address.

Methods in Vtable Order

The IADsPrintQueue interface inherits the methods of the standard COM interfaces:

• IUnknown
• IDispatch

In addition, IADsPrintQueue defines the following methods.

Properties

The IADsPrintQueue interface defines the following properties. The preceding table includes access methods for these properties.

Remarks

Use this interface to browse a collection of print jobs in the print queue. To control a printer across a network, use the IADsPrintQueueOperations interface. To obtain a collection of the print jobs, call the IADsPrintQueueOperations::PrintJobs method.

In Windows® NT/Windows 2000, a printer, or a print queue, is managed by a host computer. If the path to a print queue is known, you can bind to it as you would to any other ADSI objects. See the following code example.

Dim pq as IADsPrintQueue
Set pq = GetObject("WinNT://aMachine/aPrinter")

or in C++,

IADsPrintQueue *pq;
LPWSTR adsPath = L"WinNT://aMachine/aPrinter";
HRESULT hr = ADsGetObject(adsPath,
						IID_IADsPrintQueue,
						(void**)&pq);

To enumerate all print queues on a given computer, proceed as follows

1. Bind to the computer object.
2. Determine if the computer contains any "PrintQueue" objects.
3. Enumerate all the found printer objects.

Example Code [Visual Basic]

The following code example enumerates all the printers on a given computer.

Dim cont As IADsContainer
Dim pq As IADsPrintQueue

On Error GoTo Cleanup
 
' Bind to the computer object
Set cont = GetObject("WinNT://fabrikam1,computer")

cont.Filter = Array("PrintQueue")

For Each p In cont
   Set pq = GetObject(p.ADsPath)
   MsgBox pq.Name & " is a " & pq.Model
Next p

Cleanup:
	If (Err.Number<>0) Then
		MsgBox("An error has occurred. " & Err.Number)
	End If
	Set cont = Nothing
	Set pq = Nothing

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Redistributable: Requires Active Directory Client Extension on Windows NT 4.0 SP6a and Windows 95/98/Me.
Header: Declared in Iads.h.

See Also

IADsPrintQueueOperations, IADsPrintQueueOperations::PrintJobs, IADsPrintQueue Property Methods