Funzione SetDefaultPrinter
La funzione SetDefaultPrinter imposta il nome della stampante predefinita per l'utente corrente nel computer locale.
Sintassi
BOOL SetDefaultPrinter(
_In_ LPCTSTR pszPrinter
);
Parametri
-
pszPrinter [in]
-
Puntatore a una stringa con terminazione Null contenente il nome della stampante predefinito. Per una connessione alla stampante remota, il formato del nome è **\\server\**printername. Per una stampante locale, il formato del nome è printername.
Se questo parametro è NULL o una stringa vuota, ovvero "", SetDefaultPrinter selezionerà una stampante predefinita da una delle stampanti installate. Se esiste già una stampante predefinita, chiamare SetDefaultPrinter con un valore NULL o una stringa vuota in questo parametro potrebbe modificare la stampante predefinita.
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
Quando si usa questo metodo, è necessario specificare una stampante, un driver e una porta validi. Se non sono validi, le API non hanno esito negativo, ma il risultato non è definito. Ciò potrebbe causare l'impostazione della stampante da parte di altri programmi sulla stampante valida precedente. È possibile utilizzare EnumPrinters per recuperare il nome della stampante, il nome del driver e il nome della porta di tutte le stampanti disponibili.
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.
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 |
SetDefaultPrinterW (Unicode) e SetDefaultPrinterA (ANSI) |