Compartilhar via

Estrutura CONNECTDLGSTRUCTA (winnetwk.h)

  • Artigo

A estrutura CONNECTDLGSTRUCT é usada pela função WNetConnectionDialog1 para estabelecer parâmetros de caixa de diálogo de navegação.

Sintaxe

typedef struct _CONNECTDLGSTRUCTA {
  DWORD          cbStructure;
  HWND           hwndOwner;
  LPNETRESOURCEA lpConnRes;
  DWORD          dwFlags;
  DWORD          dwDevNum;
} CONNECTDLGSTRUCTA, *LPCONNECTDLGSTRUCTA;

Membros

cbStructure

Tipo: DWORD

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

hwndOwner

Tipo: HWND

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

lpConnRes

Tipo: LPNETRESOURCE

Um ponteiro para uma estrutura de NETRESOURCE.

Se o lpRemoteName membro do NETRESOURCE for especificado, ele será inserido no campo de caminho da caixa de diálogo. Com exceção do membro dwType , todos os outros membros da estrutura NETRESOURCE devem ser definidos como NULL. O membro dwType deve ser igual a RESOURCETYPE_DISK.

O sistema não dá suporte ao sinalizador RESOURCETYPE_PRINT para navegar e se conectar aos recursos de impressão.

dwFlags

Tipo: DWORD

Um conjunto de sinalizadores de bits que descrevem as opções para a exibição da caixa de diálogo. Esse membro pode ser uma combinação dos valores a seguir.

Valor Significado
sidTypeUser
 A conta é uma conta de usuário.
CONNDLG_RO_PATH
 Exiba um caminho somente leitura em vez de permitir que o usuário digite um caminho.

Esse sinalizador deve ser definido somente se o lpRemoteName membro da estrutura NETRESOURCE apontado por membro lpConnRes não estiver NULL (ou uma cadeia de caracteres vazia) e o sinalizador CONNDLG_USE_MRU não estiver definido.
CONNDLG_CONN_POINT
 Sinalizador interno. Não use.
CONNDLG_USE_MRU
 Insira os caminhos usados mais recentemente na caixa de combinação. Defina esse valor para simular a função WNetConnectionDialog .
CONNDLG_HIDE_BOX
 Mostrar a caixa de seleção permitindo que o usuário restaure a conexão no logon.
CONNDLG_PERSIST
 Restaure a conexão no logon.
CONNDLG_NOT_PERSIST
 Não restaure a conexão no logon.
 

Para obter mais informações, consulte a seção Comentários a seguir.

dwDevNum

Tipo: DWORD

Se a chamada para a função WNetConnectionDialog1 for bem-sucedida, esse membro retornará o número do dispositivo conectado. O valor é 1 para A:, 2 para B:, 3 para C:, e assim por diante. Se o usuário fez uma conexão sem dispositivo, o valor será –1.

Observações

Se nem o CONNDLG_RO_PATH nem o sinalizador CONNDLG_USE_MRU estiver definido e o lpRemoteName membro da estrutura NETRESOURCE não especificar um caminho remoto, a solicitação usará como padrão o tipo de exibição da caixa de diálogo CONNDLG_RO_PATH.

Os valores CONNDLG_PERSIST e CONNDLG_NOT_PERSIST não podem ser definidos. Se nenhum dos dois estiver definido, a caixa de diálogo usará como padrão a última opção selecionada nesta caixa de diálogo para o tipo específico de conexão do dispositivo.

Nota

O cabeçalho winnetwk.h define CONNECTDLGSTRUCT 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

NETRESOURCE

WNetConnectionDialog1

Visão geral WNet (Rede windows)

estruturas de rede do Windows