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	Winspool.h (include Windows.h)
Libreria	Winspool.lib
DLL	Winspool.drv
Nomi Unicode e ANSI	EnumPrintProcessorDatatypesW (Unicode) e EnumPrintProcessorDatatypesA (ANSI)

Vedi anche

Stampa

Funzioni dell'API spooler di stampa

DATATYPES_INFO_1

EnumPrintProcessors