Funzione GetPrinterDriver

La funzione GetPrinterDriver recupera i dati del driver per la stampante specificata. Se il driver non è installato nel computer locale, GetPrinterDriver lo installa.

Sintassi

BOOL GetPrinterDriver(
  _In_  HANDLE  hPrinter,
  _In_  LPTSTR  pEnvironment,
  _In_  DWORD   Level,
  _Out_ LPBYTE  pDriverInfo,
  _In_  DWORD   cbBuf,
  _Out_ LPDWORD pcbNeeded
);

Parametri

hPrinter [in]

Handle alla stampante per cui devono essere recuperati i dati del driver. Usare la funzione OpenPrinter o AddPrinter per recuperare un handle della stampante.

pEnvironment [in]

Puntatore a una stringa con terminazione null che specifica l'ambiente ,ad esempio Windows x86, Windows IA64 o Windows x64. Se questo parametro è NULL, viene usato l'ambiente corrente dell'applicazione chiamante e del computer client (non dell'applicazione di destinazione e del server di stampa).

Livello [in]

Struttura del driver della stampante restituita nel buffer pDriverInfo . Questo parametro può avere uno dei valori seguenti.

Valore	Significato
1	DRIVER_INFO_1
2	DRIVER_INFO_2
3	DRIVER_INFO_3
4	DRIVER_INFO_4
5	DRIVER_INFO_5
6	DRIVER_INFO_6
8	DRIVER_INFO_8

pDriverInfo [out]

Puntatore a un buffer che riceve una struttura contenente informazioni sul driver, come specificato da Level. Il buffer deve essere abbastanza grande per archiviare le stringhe a cui puntano i membri della struttura.

Per determinare le dimensioni del buffer necessarie, chiamare GetPrinterDriver con cbBuf impostato su zero. GetPrinterDriver 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]

Dimensioni, in byte, della matrice in corrispondenza della quale pDriverInfo punta.

pcbNeeded [out]

Puntatore a un valore che riceve il numero di byte copiati se la funzione ha esito positivo o il numero di byte necessari se cbBuf è troppo piccolo.

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.

Per un driver non esistente, la funzione restituisce ERROR_UNKNOWN_PRINTER_DRIVER.

Commenti

Nota

Si tratta di una funzione di blocco o sincrona e potrebbe non restituire immediatamente. La velocità con cui questa funzione restituisce 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. La chiamata a questa funzione da un thread che gestisce l'interazione con l'interfaccia utente potrebbe rendere l'applicazione non rispondente.

Le struttureDRIVER_INFO_2, DRIVER_INFO_3, DRIVER_INFO_4, DRIVER_INFO_5 e DRIVER_INFO_6 contengono il nome del file o il nome completo del driver della stampante nel membro pDriverPath. Un'applicazione può usare il percorso e il nome del file per caricare un driver della stampante chiamando la funzione LoadLibrary e specificando il percorso e il nome del file come singolo argomento.

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	GetPrinterDriverW (Unicode) e GetPrinterDriverA (ANSI)

Vedi anche

Stampa

Funzioni dell'API spooler di stampa

Addprinterdriver

DRIVER_INFO_1

DRIVER_INFO_2

DRIVER_INFO_3

DRIVER_INFO_4

DRIVER_INFO_5

DRIVER_INFO_6

EnumPrinterDrivers

OpenPrinter