Compartilhar via

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

Tipo: HWND

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

lpLocalName

Tipo: LPTSTR

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

lpRemoteName

Tipo: LPTSTR

Um ponteiro para uma cadeia de caracteres NULLterminada que especifica o nome do recurso de rede a ser desconectado. Esse membro poderá ser NULL se o membro lpLocalName for especificado. Quando lpLocalName é especificada, 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 será válido somente 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 ainda deseja se desconectar. Se o usuário quiser continuar, o procedimento de desconexão tentará novamente com força adicional.

Observações

Nota

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. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows 2000 Server [somente aplicativos da área de trabalho]
cabeçalho winnetwk.h

Consulte também

WNetDisconnectDialog1

Visão geral WNet (Rede windows)

estruturas de rede do Windows