Compartilhar via


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
Winspool.h (inclua Windows.h)
Biblioteca
Winspool.lib
DLL
Winspool.drv
Nomes Unicode e ANSI
SetDefaultPrinterW (Unicode) e SetDefaultPrinterA (ANSI)

Confira também

Impressão

Funções da API do Spooler de impressão

EnumPrinters

GetDefaultPrinter