Compartilhar via


Função GetDefaultPrinter

A função GetDefaultPrinter recupera o nome da impressora padrão para o usuário atual no computador local.

Sintaxe

BOOL GetDefaultPrinter(
  _In_    LPTSTR  pszBuffer,
  _Inout_ LPDWORD pcchBuffer
);

Parâmetros

pszBuffer [in]

Um ponteiro para um buffer que recebe uma cadeia de caracteres terminada em nulo que contém o nome da impressora padrão. Se esse parâmetro for NULL, a função falhará e a variável apontada por pcchBuffer retornará o tamanho do buffer necessário, em caracteres.

pcchBuffer [in, out]

Na entrada, especifica o tamanho, em caracteres, do buffer pszBuffer . Na saída, recebe o tamanho, em caracteres, da cadeia de caracteres de nome da impressora, incluindo o caractere nulo de terminação.

Valor retornado

Se a função for bem-sucedida, o valor retornado será um valor diferente de zero e a variável apontada por pcchBuffer conterá o número de caracteres copiados para o buffer pszBuffer , incluindo o caractere nulo de terminação.

Se a função falhar, o valor retornado será zero.

Valor Significado
ERROR_INSUFFICIENT_BUFFER O buffer pszBuffer é muito pequeno. A variável apontada por pcchBuffer contém o tamanho do buffer necessário, em caracteres.
ERROR_FILE_NOT_FOUND Não há impressora padrão.

Comentários

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

Confira também

Impressão

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

SetDefaultPrinter