共用方式為

IADsPrintQueue 屬性方法

  • 發行項

IADsPrintQueue介面的屬性方法會取得或設定下表所述的屬性。 如需詳細資訊，請參閱 Interface 屬性方法。

屬性

BannerPage

指向用來分隔列印工作之橫幅頁面的檔案系統路徑。 如果 為 Null，則不會使用任何橫幅頁面。

存取類型：讀取/寫入

腳本資料類型： BSTR

// C++ method syntax
HRESULT get_BannerPage(
  [out] BSTR* pbstrBannerPage
);
HRESULT put_BannerPage(
  [in] BSTR bstrBannerPage
);

資料類型

這個佇列可以處理的資料類型。

存取類型：讀取/寫入

腳本資料類型： BSTR

// C++ method syntax
HRESULT get_Datatype(
  [out] BSTR* pbstrDatatype
);
HRESULT put_Datatype(
  [in] BSTR bstrDatatype
);

DefaultJobPriority

指派給每個列印工作的預設優先順序。

存取類型：讀取/寫入

腳本資料類型： BSTR

// C++ method syntax
HRESULT get_DefaultJobPriority(
  [out] LONG* plDefaultJobPriority
);
HRESULT put_DefaultJobPriority(
  [in] BSTR lDefaultJobPriority
);

說明

這個列印佇列的文字描述。

存取類型：讀取/寫入

腳本資料類型： BSTR

// C++ method syntax
HRESULT get_Description(
  [out] BSTR* pbstrDescription
);
HRESULT put_Description(
  [in] BSTR bstrDescription
);

HostComputer

參考主機電腦的 ADsPath 字串。

存取類型：讀取/寫入

腳本資料類型： BSTR

// C++ method syntax
HRESULT get_HostComputer(
  [out] BSTR* pbstrHostComputer
);
HRESULT put_HostComputer(
  [in] BSTR bstrHostComputer
);

位置

佇列的位置，如系統管理員所述。

存取類型：讀取/寫入

腳本資料類型： BSTR

// C++ method syntax
HRESULT get_Location(
  [out] BSTR* pbstrLocation
);
HRESULT put_Location(
  [in] BSTR bstrLocation
);

型號

這個列印佇列所使用的驅動程式名稱。

存取類型：讀取/寫入

腳本資料類型： BSTR

// C++ method syntax
HRESULT get_Model(
  [out] BSTR* pbstrModel
);
HRESULT put_Model(
  [in] BSTR bstrModel
);

PrintDevices

BSTR的 SAFEARRAY，其中包含此列印佇列多工緩衝處理作業的列印裝置名稱。

存取類型：讀取/寫入

腳本資料類型： VARIANT

// C++ method syntax
HRESULT get_PrintDevices(
  [out] VARIANT* pvPrintDevices
);
HRESULT put_PrintDevices(
  [in] VARIANT vPrintDevices
);

PrinterPath

參考可存取共用印表機路徑的字串。

存取類型：讀取/寫入

腳本資料類型： BSTR

// C++ method syntax
HRESULT get_PrinterPath(
  [out] BSTR* pbstrPrinterPath
);
HRESULT put_PrinterPath(
  [in] BSTR bstrPrinterPath
);

PrintProcessor

與此佇列相關聯的列印處理器。

存取類型：讀取/寫入

腳本資料類型： BSTR

// C++ method syntax
HRESULT get_PrintProcessor(
  [out] BSTR* pbstrPrintProcessor
);
HRESULT put_PrintProcessor(
  [in] BSTR bstrPrintProcessor
);

優先順序

此印表機物件工作佇列中任何已連線裝置的優先順序。 優先處理優先順序較高的列印佇列物件中的所有作業。

存取類型：讀取/寫入

腳本資料類型： LONG

// C++ method syntax
HRESULT get_Priority(
  [out] LONG* plPriority
);
HRESULT put_Priority(
  [in] LONG lPriority
);

StartTime

佇列應該開始處理作業的時間。 會忽略時間的日期部分。

存取類型：讀取/寫入

腳本資料類型： DATE

// C++ method syntax
HRESULT get_StartTime(
  [out] DATE* pdateStartTime
);
HRESULT put_StartTime(
  [in] DATE dateStartTime
);

UntilTime

佇列應該停止處理作業的時間。

存取類型：讀取/寫入

腳本資料類型： DATE

// C++ method syntax
HRESULT get_UntilTime(
  [out] DATE* pdateUntilTime
);
HRESULT put_UntilTime(
  [in] DATE dateUntilTime
);

範例

下列程式碼範例示範如何判斷指定的印表機是否在線上或離線。

Dim pq As IADsPrintQueue
Dim pqo As IADsPrintQueueOperations
On Error GoTo Cleanup
 
Set pq = GetObject("WinNT://aMachine/aPrinter")
Set pqo = pq
If pqo.status = ADS_PRINTER_OFFLINE Then
    MsgBox pq.Model & "@" & pq.Location & is offline."
Else
    MsgBox pq.Model & "@" & pq.Location & is online."
End If

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

下列程式碼範例示範如何判斷指定的印表機是否在線上或離線。

IADsPrintQueue *pq = NULL;
HRESULT hr = S_OK;
IADsPrintQueueOperations *pqo = NULL;
BSTR model = NULL;
BSTR location = NULL;

LPWSTR adsPath = L"WinNT://aMachine/aPrinter";
hr = ADsGetObject(adsPath,
                  IID_IADsPrintQueue,
                  (void**)&pq);
if(FAILED(hr)) {goto Cleanup;}


hr = pq->QueryInterface(IID_IADsPrintQueueOperations,(void**)&pqo);
if(FAILED(hr)) {goto Cleanup;}

long status;
hr = pqo->get_Status(&status);
if(FAILED(hr)) {goto Cleanup;}

hr = pq->get_Model(&model);
if(FAILED(hr)) {goto Cleanup;}

hr =pq->get_Location(&location);
if(FAILED(hr)) {goto Cleanup;}

if(status == ADS_PRINTER_OFFLINE) 
{
    printf("%S @ %S is offline.\n",model,location);
} 
else 
{
    printf("%S @ %S is online.\n",model,location);
}


Cleanup:
    SysFreeString(model);
    SysFreeString(location);
    if(pq) pq->Release();
    if(pqo) pqo->Release();

規格需求

需求 值
最低支援的用戶端
 Windows Vista
最低支援的伺服器
 Windows Server 2008
標頭
Iads.h
DLL
Activeds.dll
IID
 IID_IADsPrintQueue定義為 B15160D0-1226-11CF-A985-00AA006BC149

另請參閱

IADsPrintQueue

Interface 屬性方法