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 |
|
| Biblioteca |
|
| DLL |
|