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

Vedi anche

Stampa

Funzioni dell'API spooler di stampa

Enumprinters

GetDefaultPrinter