Função WNetConnectionDialog (winnetwk.h)
A função WNetConnectionDialog inicia uma caixa de diálogo de navegação geral para se conectar aos recursos de rede. A função requer um identificador para a janela proprietário da caixa de diálogo.
Sintaxe
DWORD WNetConnectionDialog(
[in] HWND hwnd,
[in] DWORD dwType
);
Parâmetros
[in] hwnd
Manipule para a janela do proprietário da caixa de diálogo.
[in] dwType
Tipo de recurso para permitir conexões. Esse parâmetro pode ser o valor a seguir.
| Valor | Significado |
|---|---|
|
Conexões com recursos de disco. |
Valor retornado
Se a função for bem-sucedida, o valor retornado será NO_ERROR. Se o usuário cancelar a caixa de diálogo, a função retornará –1.
Se a função falhar, o valor retornado será um código de erro do sistema, como um dos valores a seguir.
| Código de retorno | Descrição |
|---|---|
|
Ocorreu um erro específico da rede. Para obter uma descrição do erro, chame a função WNetGetLastError . |
|
A senha especificada é inválida. |
|
A rede não está disponível. |
|
Não há memória suficiente para iniciar a caixa de diálogo. |
Comentários
Se o usuário clicar em OK na caixa de diálogo, a conexão de rede solicitada será feita quando a função WNetConnectionDialog retornar.
Se a função tentar fazer uma conexão e o provedor de rede retornar a mensagem ERROR_INVALID_PASSWORD, o sistema solicitará que o usuário insira uma senha. O sistema usa a nova senha em outra tentativa de fazer a conexão.
Requisitos
| 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] |
| Plataforma de Destino | Windows |
| Cabeçalho | winnetwk.h |
| Biblioteca | Mpr.lib |
| DLL | Mpr.dll |