Estrutura CONNECTDLGSTRUCTA (winnetwk.h)

A estrutura CONNECTDLGSTRUCT é usada pela função WNetConnectionDialog1 para estabelecer parâmetros da 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

Digite: HWND

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

lpConnRes

Tipo: LPNETRESOURCE

Um ponteiro para uma estrutura NETRESOURCE .

Se o membro lpRemoteName de NETRESOURCE for especificado, ele será inserido no campo 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 navegação e conexão com 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 só deverá ser definido se o membro lpRemoteName da estrutura NETRESOURCE apontado pelo membro lpConnRes não for 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	Mostre a caixa marcar 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.

Comentários

Se nem o CONNDLG_RO_PATH nem o sinalizador CONNDLG_USE_MRU estiver definido e o membro lpRemoteName 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 de dispositivo.

Observação

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. 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

NETRESOURCE

WNetConnectionDialog1

Visão geral da Rede do Windows (WNet)

Estruturas de rede do Windows