Directory Services

IADsPrintQueueOperations Property Methods

The property methods of the IADsPrintQueueOperations interface read and write the properties listed in the following table. For more information about property methods, see Interface Property Methods.

Properties

Property Description
Status

[Visual Basic]
Access: Read/Write
DataType: Long

[C++]
HRESULT get_Name
([out] LONG* pbstrName);
HRESULT put_Name
([in] LONG bstrName);

Current status of the print queue operations. The valid status code values are listed in the following table.
ADS_PRINTER_PAUSED
0x00000001
ADS_PRINTER_PENDING_DELETION
0x00000002
ADS_PRINTER_ERROR
0x00000003
ADS_PRINTER_PAPER_JAM
0x00000004
ADS_PRINTER_PAPER_OUT
0x00000005
ADS_PRINTER_MANUAL_FEED
0x00000006
ADS_PRINTER_PAPER_PROBLEM
0x00000007
ADS_PRINTER_OFFLINE
0x00000008
ADS_PRINTER_IO_ACTIVE
0x00000100
ADS_PRINTER_BUSY
0x00000200
ADS_PRINTER_PRINTING
0x00000400
ADS_PRINTER_OUTPUT_BIN_FULL
0x00000800
ADS_PRINTER_NOT_AVAILABLE
0x00001000
ADS_PRINTER_WAITING
0x00002000
ADS_PRINTER_PROCESSING
0x00004000
ADS_PRINTER_INITIALIZING
0x00008000
ADS_PRINTER_WARMING_UP
0x00010000
ADS_PRINTER_TONER_LOW
0x00020000
ADS_PRINTER_NO_TONER
0x00040000
ADS_PRINTER_PAGE_PUNT
0x00080000
ADS_PRINTER_USER_INTERVENTION
0x00100000
ADS_PRINTER_OUT_OF_MEMORY
0x00200000
ADS_PRINTER_DOOR_OPEN
0x00400000
ADS_PRINTER_SERVER_UNKNOWN
0x00800000
ADS_PRINTER_POWER_SAVE
0x01000000

Example Code [Visual Basic]

The following Visual Basic code example verifies that a printer is jammed.

Dim pqo As IADsPrintQueueOperations
Set pqo = GetObject("WinNT://aMachine/aPrinter")
If pqo.Status = ADS_PRINTER_PAPER_JAM Then
MsgBox "Your printer is jammed."
End If

Example Code [C++]

The following C++ code example verifies that a printer is jammed.

IADsPrintQueueOperations *pqo;
HRESULT hr = ADsGetObject(L"WinNT://aMachine/aPrinter",
IID_IADsPrintQueueOperations,
(void**)&pqo)
long status;
hr = pqo->get_Status(&status);
if(status = ADS_PRINTER_PAPER_JAM) {
printf("Your printer is jammed.\n");
}
hr = pqo->Release();

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

IADsPrintQueue, IADsPrintQueueOperations