Função WNetDisconnectDialog (winnetwk.h)

Artigo
08/27/2023

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