Funzione EnumPrintProcessorDatatypes
La funzione EnumPrintProcessorDatatypes enumera i tipi di dati supportati da un processore di stampa specificato.
Sintassi
BOOL EnumPrintProcessorDatatypes(
_In_ LPTSTR pName,
_In_ LPTSTR pPrintProcessorName,
_In_ DWORD Level,
_Out_ LPBYTE pDatatypes,
_In_ DWORD cbBuf,
_Out_ LPDWORD pcbNeeded,
_Out_ LPDWORD pcReturned
);
Parametri
-
pName [in]
-
Puntatore a una stringa con terminazione Null che specifica il nome del server in cui risiede il processore di stampa. Se questo parametro è NULL, vengono enumerati i tipi di dati per il processore di stampa locale.
-
pPrintProcessorName [in]
-
Puntatore a una stringa con terminazione Null che specifica il nome del processore di stampa i cui tipi di dati sono enumerati.
-
Livello [in]
-
Tipo di informazioni restituite nel buffer pDatatypes . Questo parametro deve essere 1.
-
pDatatypes [out]
-
Puntatore a un buffer che riceve una matrice di strutture DATATYPES_INFO_1 . Ogni struttura descrive un tipo di dati disponibile. Il buffer deve essere sufficientemente grande per ricevere la matrice di strutture e qualsiasi stringa o altri dati a cui puntano i membri della struttura.
Per determinare le dimensioni del buffer necessarie, chiamare EnumPrintProcessorDatatypes con cbBuf impostato su zero. EnumPrintProcessorDatatypes ha esito negativo, GetLastError restituisce ERROR_INSUFFICIENT_BUFFER e il parametro pcbNeeded restituisce le dimensioni, in byte, del buffer necessario per contenere la matrice di strutture e i relativi dati.
-
cbBuf [in]
-
Dimensione, in byte, del buffer a cui punta pDatatypes.
-
pcbNeeded [out]
-
Puntatore a una variabile che riceve il numero di byte copiati nel buffer pDatatypes se la funzione ha esito positivo. Se il buffer è troppo piccolo, la funzione ha esito negativo e la variabile riceve il numero di byte necessari.
-
pcReturned [out]
-
Puntatore a una variabile che riceve il numero di strutture restituite nel buffer pDatatypes . Questo è il numero di tipi di dati supportati.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero.
Commenti
Nota
Si tratta di una funzione di blocco o sincrona e potrebbe non restituire immediatamente. La velocità di restituzione di questa funzione dipende da fattori di runtime come lo stato della rete, la configurazione del server di stampa e i fattori di implementazione del driver della stampante difficili da prevedere durante la scrittura di un'applicazione. Chiamando questa funzione da un thread che gestisce l'interazione con l'interfaccia utente, l'applicazione potrebbe sembrare non rispondente.
v
A partire da Windows Vista, le informazioni sul tipo di dati dai server di stampa remoti vengono recuperate da una cache locale.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|
| Nomi Unicode e ANSI |
EnumPrintProcessorDatatypesW (Unicode) e EnumPrintProcessorDatatypesA (ANSI) |