Méthodes de propriété IADsPrintQueue
Les méthodes de propriété de l’interface IADsPrintQueue 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
-
BannerPage
-
-
Type d’accès : lecture/écriture
-
Type de données de script : BSTR
-
// C++ method syntax HRESULT get_BannerPage( [out] BSTR* pbstrBannerPage ); HRESULT put_BannerPage( [in] BSTR bstrBannerPage );
Chemin d’accès du système de fichiers qui pointe vers la page de bannière utilisée pour séparer les travaux d’impression. Si la valeur est null, aucune page de bannière n’est utilisée.
-
-
Décimal
-
-
Type d’accès : lecture/écriture
-
Type de données de script : BSTR
-
// C++ method syntax HRESULT get_Datatype( [out] BSTR* pbstrDatatype ); HRESULT put_Datatype( [in] BSTR bstrDatatype );
Type de données qui peut être traité par cette file d’attente.
-
-
DefaultJobPriority
-
-
Type d’accès : lecture/écriture
-
Type de données de script : BSTR
-
// C++ method syntax HRESULT get_DefaultJobPriority( [out] LONG* plDefaultJobPriority ); HRESULT put_DefaultJobPriority( [in] BSTR lDefaultJobPriority );
Priorité par défaut assignée à chaque travail d’impression.
-
-
Description
-
-
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 );
Description textuelle de cette file d’attente à l’impression.
-
-
HostComputer
-
-
Type d’accès : lecture/écriture
-
Type de données de script : BSTR
-
// C++ method syntax HRESULT get_HostComputer( [out] BSTR* pbstrHostComputer ); HRESULT put_HostComputer( [in] BSTR bstrHostComputer );
Chaîne ADsPath qui fait référence à l’ordinateur hôte.
-
-
Lieu
-
-
Type d’accès : lecture/écriture
-
Type de données de script : BSTR
-
// C++ method syntax HRESULT get_Location( [out] BSTR* pbstrLocation ); HRESULT put_Location( [in] BSTR bstrLocation );
Emplacement de la file d’attente comme décrit par un administrateur.
-
-
Modèle
-
-
Type d’accès : lecture/écriture
-
Type de données de script : BSTR
-
// C++ method syntax HRESULT get_Model( [out] BSTR* pbstrModel ); HRESULT put_Model( [in] BSTR bstrModel );
Nom du pilote utilisé par cette file d’attente à l’impression.
-
-
PrintDevices
-
-
Type d’accès : lecture/écriture
-
Type de données de script : variante
-
// C++ method syntax HRESULT get_PrintDevices( [out] VARIANT* pvPrintDevices ); HRESULT put_PrintDevices( [in] VARIANT vPrintDevices );
SAFEARRAY de BSTR qui contient les noms des périphériques d’impression auxquels cette file d’attente à l’impression met en file d’attente les travaux.
-
-
PrinterPath
-
-
Type d’accès : lecture/écriture
-
Type de données de script : BSTR
-
// C++ method syntax HRESULT get_PrinterPath( [out] BSTR* pbstrPrinterPath ); HRESULT put_PrinterPath( [in] BSTR bstrPrinterPath );
Chaîne qui fait référence au chemin d’accès par lequel une imprimante partagée est accessible.
-
-
PrintProcessor
-
-
Type d’accès : lecture/écriture
-
Type de données de script : BSTR
-
// C++ method syntax HRESULT get_PrintProcessor( [out] BSTR* pbstrPrintProcessor ); HRESULT put_PrintProcessor( [in] BSTR bstrPrintProcessor );
Processeur d’impression associé à cette file d’attente.
-
-
Priorité
-
-
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 );
Priorité de la file d’attente des travaux de l’objet imprimante pour tous les appareils connectés. Toutes les tâches dans les objets de file d’attente à l’impression de priorité supérieure sont traitées en premier.
-
-
StartTime
-
-
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 );
Heure à laquelle la file d’attente doit commencer le traitement des tâches. La partie Date de l’heure est ignorée.
-
-
UntilTime
-
-
Type d’accès : lecture/écriture
-
Type de données de script : Date
-
// C++ method syntax HRESULT get_UntilTime( [out] DATE* pdateUntilTime ); HRESULT put_UntilTime( [in] DATE dateUntilTime );
Heure à laquelle la file d’attente doit arrêter le traitement des tâches.
-
Exemples
L’exemple de code suivant montre comment déterminer si une imprimante spécifiée est en ligne ou hors connexion.
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
L’exemple de code suivant montre comment déterminer si une imprimante spécifiée est en ligne ou hors connexion.
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();
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| En-tête |
|
| DLL |
|
| IID |
IID _ IADsPrintQueue est défini en tant que B15160D0-1226-11CF-A985-00AA006BC149 |