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