Compartilhar via


Função ConnectToPrinterDlg

A função ConnectToPrinterDlg exibe uma caixa de diálogo que permite que os usuários naveguem e se conectem a impressoras em uma rede. Se o usuário selecionar uma impressora, a função tentará criar uma conexão com ela; se um driver adequado não estiver instalado no servidor, o usuário recebe a opção de criar uma impressora localmente.

Sintaxe

HANDLE ConnectToPrinterDlg(
  _In_ HWND  hwnd,
  _In_ DWORD Flags
);

Parâmetros

hwnd [in]

Especifica a janela pai da caixa de diálogo.

Sinalizadores [in]

Esse parâmetro é reservado e precisa ser zero.

Valor retornado

Se a função for bem-sucedida e o usuário selecionar uma impressora, o valor retornado será um identificador para a impressora selecionada.

Se a função falhar ou o usuário cancelar a caixa de diálogo sem selecionar uma impressora, o valor retornado será NULL.

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 do driver de impressora que são difíceis de prever ao gravar 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.

A função ConnectToPrinterDlg tenta criar uma conexão com a impressora selecionada. No entanto, se o servidor no qual a impressora reside não tiver um driver adequado instalado, a função oferecerá ao usuário a opção de criar uma impressora localmente. Um aplicativo de chamada pode determinar se a função criou uma impressora localmente chamando GetPrinter com uma estrutura PRINTER_INFO_2 e examinando o membro Atributos dessa estrutura.

Um aplicativo deve chamar DeletePrinter para excluir uma impressora local. Um aplicativo deve chamar DeletePrinterConnection para excluir uma conexão com uma impressora.

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

Confira também

Impressão

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

AddPrinterConnection

ClosePrinter

DeletePrinter

DeletePrinterConnection

GetPrinter

PRINTER_INFO_2