Função SetDefaultPrinter
A função SetDefaultPrinter define o nome da impressora padrão para o usuário atual no computador local.
Sintaxe
BOOL SetDefaultPrinter(
_In_ LPCTSTR pszPrinter
);
Parâmetros
-
pszPrinter [in]
-
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome da impressora padrão. Para uma conexão de impressora remota, o formato de nome é **\\nomeda impressorado servidor\**. Para uma impressora local, o formato de nome é printername.
Se esse parâmetro for NULL ou uma cadeia de caracteres vazia, ou seja, "", SetDefaultPrinter selecionará uma impressora padrão de uma das impressoras instaladas. Se já existir uma impressora padrão, chamar SetDefaultPrinter com um NULL ou uma cadeia de caracteres vazia nesse parâmetro poderá alterar a impressora padrão.
Valor retornado
Se a função for bem-sucedida, o valor retornado será um valor diferente de zero.
Se a função falhar, o valor retornado será zero.
Comentários
Ao usar esse método, você deve especificar uma impressora, um driver e uma porta válidos. Se forem inválidas, as APIs não falharão, mas o resultado não será definido. Isso pode fazer com que outros programas definam a impressora de volta para a impressora válida anterior. Você pode usar EnumPrinters para recuperar o nome da impressora, o nome do driver e o nome da porta de todas as impressoras disponíveis.
Observação
Essa é uma função de bloqueio ou síncrona e pode não retornar imediatamente. A rapidez com que essa função retorna depende de fatores de tempo de execução, como status de rede, configuração do servidor de impressão e fatores de implementação de driver de impressora que são difíceis de prever ao escrever um aplicativo. Chamar essa função de um thread que gerencia a interação com a interface do usuário pode fazer com que o aplicativo pareça não responder.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| Biblioteca |
|
| DLL |
|
| Nomes Unicode e ANSI |
SetDefaultPrinterW (Unicode) e SetDefaultPrinterA (ANSI) |