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