Função WNetRestoreConnectionW (winnetwk.h)

  • Artigo

[WNetRestoreConnectionW não está disponível para uso a partir do Windows Vista.]

A função WNetRestoreConnectionW restaura a conexão com um recurso de rede. A função solicita ao usuário, se necessário, um nome e uma senha.

Sintaxe

DWORD WNetRestoreConnectionW(
  [in] HWND    hWnd,
  [in] LPCWSTR lpDevice
);

Parâmetros

[in] hWnd

Manipule para a janela pai que a função usa para exibir a interface do usuário que solicita ao usuário um nome e uma senha ao fazer a conexão de rede. Se esse parâmetro for NULL, não haverá nenhuma janela de proprietário.

[in] lpDevice

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo que especifica o nome local da unidade à qual se conectar, como "Z:". Se esse parâmetro for NULL, a função reconectará todas as unidades persistentes armazenadas no registro do usuário atual.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

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_ACCESS_DENIED
 O chamador não tem acesso ao recurso de rede.
ERROR_ALREADY_ASSIGNED
 O dispositivo local especificado por lpDevice já está conectado a um recurso de rede.
ERROR_BAD_DEV_TYPE
 O tipo de dispositivo local e o tipo de recurso de rede não correspondem.
ERROR_BAD_DEVICE
 O valor especificado por lpDevice é inválido.
ERROR_BAD_PROFILE
 O perfil do usuário está em um formato incorreto.
ERROR_BUSY
 O roteador ou provedor está ocupado, possivelmente inicializando. O chamador deve tentar novamente.
ERROR_CANCELLED
 A tentativa de fazer a conexão foi cancelada pelo usuário por meio de uma caixa de diálogo de um dos provedores de recursos de rede ou por um recurso chamado.
ERROR_CANNOT_OPEN_PROFILE
 O sistema não consegue abrir o perfil do usuário para processar conexões persistentes.
ERROR_DEVICE_ALREADY_REMEMBERED
 Uma entrada para o dispositivo já está no perfil do usuário.
ERROR_EXTENDED_ERROR
 Ocorreu um erro específico da rede. Chame a função WNetGetLastError para obter uma descrição do erro.
ERROR_INVALID_PASSWORD
 A senha especificada é inválida.
ERROR_NO_NET_OR_BAD_PATH
 A operação não pode ser executada porque um componente de rede não foi iniciado ou porque um nome especificado não pode ser usado.
ERROR_NO_NETWORK
 A rede não está disponível.

Comentários

Não há suporte para a função WNetRestoreConnectionW no Windows Vista e posterior.

Para chamar essa função, primeiro chame a função LoadLibrary para carregar Mpr.dll. Em seguida, chame a função GetProcAddress para recuperar o endereço da função WNetRestoreConnectionW .

WNetRestoreConnectionW é usado pelo Winlogon para restaurar todos os mapeamentos de unidade persistentes durante o processo de logon interativo. A função também é chamada pelo Shell do Microsoft Windows para reconectar unidades individuais a pedido do usuário. Isso pode ocorrer, por exemplo, quando uma unidade falha ao se reconectar no logon e o usuário clica duas vezes na unidade na pasta virtual Meu Computador.

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]
Plataforma de Destino Windows
Cabeçalho winnetwk.h
Biblioteca Mpr.lib
DLL Mpr.dll

Confira também

Visão geral da rede do Windows (WNet)

Funções de rede do Windows