Funzione GetDefaultPrinter

La funzione GetDefaultPrinter recupera il nome della stampante predefinito per l'utente corrente nel computer locale.

Sintassi

BOOL GetDefaultPrinter(
  _In_    LPTSTR  pszBuffer,
  _Inout_ LPDWORD pcchBuffer
);

Parametri

pszBuffer [in]

Puntatore a un buffer che riceve una stringa di caratteri con terminazione null contenente il nome della stampante predefinito. Se questo parametro è NULL, la funzione ha esito negativo e la variabile puntata da pcchBuffer restituisce le dimensioni del buffer necessarie, in caratteri.

pcchBuffer [in, out]

In input specifica le dimensioni, in caratteri, del buffer pszBuffer . In output, riceve le dimensioni, in caratteri, della stringa del nome della stampante, incluso il carattere Null terminante.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero e la variabile puntata da pcchBuffer contiene il numero di caratteri copiati nel buffer pszBuffer , incluso il carattere null terminante.

Se la funzione ha esito negativo, il valore restituito è zero.

Valore	Significato
ERROR_INSUFFICIENT_BUFFER	Il buffer pszBuffer è troppo piccolo. La variabile puntata da pcchBuffer contiene le dimensioni del buffer necessarie, in caratteri.
ERROR_FILE_NOT_FOUND	Non esiste alcuna stampante predefinita.

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.

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	GetDefaultPrinterW (Unicode) e GetDefaultPrinterA (ANSI)

Vedi anche

Stampa

Funzioni dell'API spooler di stampa

SetDefaultPrinter