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 |
|---|---|
|
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 |
|---|---|
|
Ocorreu um erro específico da rede. Para obter uma descrição do erro, chame a função WNetGetLastError . |
|
A rede não está disponível. |
|
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 |