Estrutura DISCDLGSTRUCTA (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 _DISCDLGSTRUCTA {
  DWORD cbStructure;
  HWND  hwndOwner;
  LPSTR lpLocalName;
  LPSTR lpRemoteName;
  DWORD dwFlags;
} DISCDLGSTRUCTA, *LPDISCDLGSTRUCTA;

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 do 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 há arquivos abertos na conexão e perguntado se ele 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