Compartilhar via

Métodos da propriedade IADsPrintJob

  • Artigo

Métodos de propriedade para a interface IADsPrintJob obtêm ou definem as propriedades descritas na tabela a seguir. Para obter mais informações, consulte Métodos de propriedade de interface.

Propriedades

Descrição

A descrição do trabalho de impressão.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

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

HostPrintQueue

A cadeia de caracteres ADsPath da Fila de Impressão que processa o trabalho de impressão.

Tipo de acesso: Somente leitura

Tipo de dados de script: BSTR

// C++ method syntax
HRESULT get_HostPrintQueue(
  [out] BSTR* pbstrHostPrintQueue
);

Notificar

O usuário a ser notificado quando o trabalho for concluído.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

// C++ method syntax
HRESULT get_Notify(
  [out] BSTR* pbstrNotify
);
HRESULT put_Notify(
  [in] BSTR bstrNotify
);

NotifyPath

A cadeia de caracteres ADsPath do objeto de usuário a ser notificado quando o trabalho de impressão for concluído.

Tipo de acesso: leitura/gravação

Tipo de dados de script: BSTR

// C++ method syntax
HRESULT get_NotifyPath(
  [out] BSTR* pbstrNotifyPath
);
HRESULT put_NotifyPath(
  [in] BSTR bstrNotifyPath
);

Prioridade

A prioridade do trabalho de impressão.

Tipo de acesso: leitura/gravação

Tipo de dados de script: LONG

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

Tamanho

O tamanho, em bytes, do trabalho de impressão.

Tipo de acesso: Somente leitura

Tipo de dados de script: LONG

// C++ method syntax
HRESULT get_Size(
  [out] LONG* plSize
);

StartTime

A primeira vez em que o trabalho de impressão deve ser iniciado.

Tipo de acesso: leitura/gravação

Tipo de dados de script: DATE

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

TimeSubmitted

A hora em que o trabalho foi enviado para a fila.

Tipo de acesso: Somente leitura

Tipo de dados de script: DATE

// C++ method syntax
HRESULT get_TimeSubmitted(
  [out] DATE* pdateTimeSubmitted
);

Totalpages

O número total de páginas no trabalho de impressão.

Tipo de acesso: Somente leitura

Tipo de dados de script: LONG

// C++ method syntax
HRESULT get_TotalPages(
  [out] LONG* plTotalPages
);

UntilTime

A hora mais recente em que o trabalho de impressão deve ser iniciado.

Tipo de acesso: leitura/gravação

Tipo de dados de script: DATE

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

Usuário

O nome do usuário que enviou o trabalho de impressão.

Tipo de acesso: Somente leitura

Tipo de dados de script: BSTR

// C++ method syntax
HRESULT get_User(
  [out] BSTR* pbstrUser
);

UserPath

A cadeia de caracteres ADsPath do objeto de usuário que enviou esse trabalho de impressão.

Tipo de acesso: Somente leitura

Tipo de dados de script: BSTR

// C++ method syntax
HRESULT get_UserPath(
  [out] BSTR* pbstrUserPath
);

Exemplos

O exemplo de código a seguir mostra como trabalhar com propriedades de um objeto de trabalho de impressão.

Dim pqo As IADsPrintQueueOperations
Dim pj As IADsPrintJob
On Error GoTo Cleanup

Set pqo = GetObject("WinNT://aMachine/aPrinter")
For Each pj In pqo.PrintJobs
    MsgBox "Host Printer: " & pj.HostPrintQueue
    MsgBox "Job description: " & pj.Description
    MsgBox "job requester: " & pj.User 
Next

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

O exemplo de código a seguir mostra como trabalhar com propriedades de um objeto de trabalho de impressão.

IADsPrintQueueOperations *pqo = NULL;
IADsPrintJob *pJob = NULL;
HRESULT hr = S_OK;
BSTR bstr = NULL;
VARIANT var;
ULONG lFetch = 0;
IDispatch *pDisp = NULL;
IADsCollection *pColl = NULL;
IUnknown *pUnk = NULL;
LPWSTR adsPath =L"WinNT://aMachine/aPrinter";

VariantInit(&var);

hr = ADsGetObject(adsPath, 
                  IID_IADsPrintQueueOperations, 
                  (void**)&pqo);
if(FAILED(hr)){goto Cleanup;}


hr = pqo->PrintJobs(&pColl);

// Enumerate print jobs. Code omitted.

hr = pColl->get__NewEnum(&pUnk);
if(FAILED(hr)){goto Cleanup;}


IEnumVARIANT *pEnum;
hr = pUnk->QueryInterface(IID_IEnumVARIANT,(void**)&pEnum);
if(FAILED(hr)){goto Cleanup;}


// Now Enumerate.
hr = pEnum->Next(1, &var, &lFetch);
if(FAILED(hr)){goto Cleanup;}

while(hr == S_OK)
{
    if (lFetch == 1)    
    {
        pDisp = V_DISPATCH(&var);
        pDisp->QueryInterface(IID_IADsPrintJob, (void**)&pJob);

        pJob->get_HostPrintQueue(&bstr);
        printf("HostPrintQueue: %S\n",bstr);
        SysFreeString(bstr);

        pJob->get_Description(&bstr);
        printf("Print job name: %S\n",bstr);
        SysFreeString(bstr);

        pJob->get_User(&bstr);
        printf("Requester: %S\n",bstr);
        SysFreeString(bstr);

        pJob->Release();
    }
    pDisp->Release();
    VariantClear(&var);
    hr = pEnum->Next(1, &var, &lFetch);
};

Cleanup:
    if(pEnum) pEnum->Release();
    if(pUnk) pUnk->Release();
    if(pColl) pColl->Release();
    if(pqo) pqo->Release();

Requisitos

Requisito Valor
Cliente mínimo com suporte
 Windows Vista
Servidor mínimo com suporte
 Windows Server 2008
Cabeçalho
Iads.h
DLL
Activeds.dll
IID
 IID_IADsPrintJob é definido como 32FB6780-1ED0-11CF-A988-00AA006BC149

Confira também

IADsPrintJob

Métodos de propriedade interface