Metodi della proprietà IADsPrintQueue

I metodi di proprietà dell'interfaccia IADsPrintQueue ottengono o impostano le proprietà descritte nella tabella seguente. Per altre informazioni, vedere Metodi di proprietà dell'interfaccia.

Proprietà

BannerPage

Percorso del file system che punta alla pagina banner utilizzata per separare i processi di stampa. Se NULL, non viene utilizzata alcuna pagina banner.

Tipo di accesso: lettura/scrittura

Tipo di dati scripting: BSTR

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

Datatype

Tipo di dati che può essere elaborato da questa coda.

Tipo di accesso: lettura/scrittura

Tipo di dati scripting: BSTR

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

DefaultJobPriority

Priorità predefinita assegnata a ogni processo di stampa.

Tipo di accesso: lettura/scrittura

Tipo di dati scripting: BSTR

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

Descrizione

Descrizione di testo della coda di stampa.

Tipo di accesso: lettura/scrittura

Tipo di dati scripting: BSTR

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

HostComputer

Stringa ADsPath che fa riferimento al computer host.

Tipo di accesso: lettura/scrittura

Tipo di dati scripting: BSTR

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

Posizione

Percorso della coda, come descritto da un amministratore.

Tipo di accesso: lettura/scrittura

Tipo di dati scripting: BSTR

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

Modello

Nome del driver utilizzato da questa coda di stampa.

Tipo di accesso: lettura/scrittura

Tipo di dati scripting: BSTR

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

PrintDevices

SAFEARRAY di BSTR che contiene i nomi dei dispositivi di stampa in cui viene eseguito lo spooling della coda di stampa.

Tipo di accesso: lettura/scrittura

Tipo di dati scripting: VARIANT

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

PrinterPath

Stringa che fa riferimento al percorso a cui è possibile accedere a una stampante condivisa.

Tipo di accesso: lettura/scrittura

Tipo di dati scripting: BSTR

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

Printprocessor

Processore di stampa associato a questa coda.

Tipo di accesso: lettura/scrittura

Tipo di dati scripting: BSTR

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

Priorità

Priorità di questa coda di processi dell'oggetto stampante per tutti i dispositivi connessi. Tutti i processi in oggetti coda di stampa con priorità più alta verranno elaborati per primi.

Tipo di accesso: lettura/scrittura

Tipo di dati scripting: LONG

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

StartTime

Ora in cui la coda deve iniziare l'elaborazione dei processi. La parte relativa alla data dell'ora viene ignorata.

Tipo di accesso: lettura/scrittura

Tipo di dati di scripting: DATE

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

UntilTime

Ora in cui la coda deve interrompere l'elaborazione dei processi.

Tipo di accesso: lettura/scrittura

Tipo di dati di scripting: DATE

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

Esempio

Nell'esempio di codice seguente viene illustrato come determinare se una stampante specificata è online o offline.

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

Nell'esempio di codice seguente viene illustrato come determinare se una stampante specificata è online o offline.

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();

Requisiti

Vedi anche

IADsPrintQueue

Metodi delle proprietà Interface