Estrutura DISCDLGSTRUCTW (winnetwk.h)

  • Artigo

A estrutura DISCDLGSTRUCT é usada na função WNetDisconnectDialog1 . A estrutura contém informações necessárias para a tentativa de desconexão.

Sintaxe

typedef struct _DISCDLGSTRUCTW {
  DWORD  cbStructure;
  HWND   hwndOwner;
  LPWSTR lpLocalName;
  LPWSTR lpRemoteName;
  DWORD  dwFlags;
} DISCDLGSTRUCTW, *LPDISCDLGSTRUCTW;

Membros

cbStructure

Tipo: DWORD

O tamanho, em bytes, da estrutura DISCDLGSTRUCT . O chamador deve fornecer esse valor.

hwndOwner

Digite: HWND

Um identificador para a janela proprietário da caixa de diálogo.

lpLocalName

Tipo: LPTSTR

Um ponteiro para uma cadeia de caracteres terminada em NULL que especifica o nome do dispositivo local que é redirecionado para o recurso de rede, como "F:" ou "LPT1".

lpRemoteName

Tipo: LPTSTR

Um ponteiro para uma cadeia de caracteres terminada em NULL que especifica o nome do recurso de rede a ser desconectado. Esse membro poderá ser NULL se o membro lpLocalName for especificado. Quando lpLocalName é especificado, a conexão com o recurso de rede redirecionada de lpLocalName é desconectada.

dwFlags

Tipo: DWORD

Um conjunto de sinalizadores de bits que descrevem a conexão. Esse membro pode ser uma combinação dos valores a seguir.

Valor Significado
DISC_UPDATE_PROFILE
 Se esse valor for definido, a conexão especificada não será mais persistente (restaurada automaticamente sempre que o usuário fizer logon). Esse sinalizador só será válido se o membro lpLocalName especificar um dispositivo local.
DISC_NO_FORCE
 Se esse valor não estiver definido, o sistema aplicará força ao tentar se desconectar do recurso de rede.

Normalmente, essa situação ocorre quando o usuário tem arquivos abertos pela conexão. Esse valor significa que o usuário será informado se houver arquivos abertos na conexão e perguntado se ele ou ela ainda deseja se desconectar. Se o usuário quiser continuar, o procedimento de desconexão tentará novamente com força adicional.

Comentários

Observação

O cabeçalho winnetwk.h define DISCDLGSTRUCT como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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]
Cabeçalho winnetwk.h

Confira também

WNetDisconnectDialog1

Visão geral da Rede do Windows (WNet)

Estruturas de rede do Windows