Compartilhar via


Função WNetDisconnectDialog (winnetwk.h)

A função WNetDisconnectDialog inicia uma caixa de diálogo de navegação geral para desconectar-se dos recursos de rede. A função requer um identificador para a janela do proprietário da caixa de diálogo.

Sintaxe

DWORD WNetDisconnectDialog(
  [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 do qual se desconectar. Esse parâmetro pode ter o valor a seguir.

Valor Significado
RESOURCETYPE_DISK
Desconecta-se dos 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, o valor retornado será –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_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

A função WNetDisconnectDialog retorna imediatamente e cria uma caixa de diálogo para desconectar unidades em rede. Essa caixa de diálogo é executada de forma assíncrona em um thread de trabalho.

Se o thread de trabalho for encerrado, a janela do proprietário e sua caixa de diálogo associada também serão encerradas. Se isso ocorrer, talvez o usuário não consiga interagir com a caixa de diálogo, pois ela não aparecerá na tela do usuário ou aparecerá brevemente.

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

WNetAddConnection2

WNetCancelConnection2

WNetConnectionDialog

WNetConnectionDialog1

Visão geral da rede do Windows (WNet)

Funções de rede do Windows