IADsPrintJob, méthodes de propriété

Les méthodes de propriété pour l’interface IADsPrintJob obtiennent ou définissent les propriétés décrites dans le tableau suivant. Pour plus d’informations, consultez Méthodes de propriété d’interface.

Propriétés

Description

Description du travail d’impression.

Type d’accès : Lecture/écriture

Type de données de script : BSTR

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

HostPrintQueue

Chaîne ADsPath de la file d’attente d’impression qui traite le travail d’impression.

Type d'accès : Lecture seule

Type de données de script : BSTR

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

Notifier

L’utilisateur doit être averti lorsque le travail est terminé.

Type d’accès : Lecture/écriture

Type de données de script : BSTR

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

NotifyPath

Chaîne ADsPath de l’objet utilisateur à notifier lorsque le travail d’impression est terminé.

Type d’accès : Lecture/écriture

Type de données de script : BSTR

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

Priorité

Priorité du travail d’impression.

Type d’accès : Lecture/écriture

Type de données de script : LONG

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

Taille

Taille, en octets, du travail d’impression.

Type d'accès : Lecture seule

Type de données de script : LONG

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

StartTime

Heure la plus ancienne à laquelle le travail d’impression doit être démarré.

Type d’accès : Lecture/écriture

Type de données de script : DATE

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

TimeSubmitted

Heure à laquelle le travail a été soumis à la file d’attente.

Type d'accès : Lecture seule

Type de données de script : DATE

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

TotalPages

Nombre total de pages dans le travail d’impression.

Type d'accès : Lecture seule

Type de données de script : LONG

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

UntilTime

Heure la plus récente à laquelle le travail d’impression doit être démarré.

Type d’accès : Lecture/écriture

Type de données de script : DATE

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

Utilisateur

Nom de l’utilisateur qui a envoyé le travail d’impression.

Type d'accès : Lecture seule

Type de données de script : BSTR

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

UserPath

Chaîne ADsPath de l’objet utilisateur qui a envoyé ce travail d’impression.

Type d'accès : Lecture seule

Type de données de script : BSTR

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

Exemples

L’exemple de code suivant montre comment utiliser les propriétés d’un objet de travail d’impression.

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

L’exemple de code suivant montre comment utiliser les propriétés d’un objet de travail d’impression.

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

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
En-tête	Iads.h
DLL	Activeds.dll
IID	IID_IADsPrintJob est défini comme 32FB6780-1ED0-11CF-A988-00AA006BC149

Voir aussi

IADsPrintJob

Méthodes de propriété d’interface