Função WNetConnectionDialog (winnetwk.h)

  • Artigo

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
RESOURCETYPE_DISK
 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
ERROR_EXTENDED_ERROR
 Ocorreu um erro específico da rede. Para obter uma descrição do erro, chame a função WNetGetLastError .
ERROR_INVALID_PASSWORD
 A senha especificada é inválida.
ERROR_NO_NETWORK
 A rede não está disponível.
ERROR_NOT_ENOUGH_MEMORY
 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

Confira também

WNetAddConnection3

WNetCancelConnection2

WNetDisconnectDialog

Visão geral da Rede do Windows (WNet)

Funções de rede do Windows