Função WNetConnectionDialog1A (winnetwk.h)

Artigo
08/27/2023

A função WNetConnectionDialog1 apresenta uma caixa de diálogo de navegação geral para se conectar aos recursos de rede. A função requer um CONNECTDLGSTRUCT para estabelecer os parâmetros da caixa de diálogo.

Sintaxe

DWORD WNetConnectionDialog1A(
  [in, out] LPCONNECTDLGSTRUCTA lpConnDlgStruct
);

Parâmetros

[in, out] lpConnDlgStruct

Ponteiro para uma estrutura CONNECTDLGSTRUCT . A estrutura estabelece os parâmetros da caixa de diálogo de navegação.

Valor retornado

Se o usuário cancelar a caixa de diálogo, a função retornará –1. Se a função for bem-sucedida, ela retornará NO_ERROR. Além disso, se a chamada for bem-sucedida, o membro dwDevNum da estrutura CONNECTDLGSTRUCT conterá o número do dispositivo conectado.

Normalmente, essa caixa de diálogo retorna um erro somente se o usuário não puder inserir uma sessão de diálogo. Isso ocorre porque erros que ocorrem após uma sessão de diálogo são relatados diretamente ao usuário. Se a função falhar, o valor retornado será um código de erro do sistema, como um dos valores a seguir.

Código de retorno	Descrição
ERROR_INVALID_PARAMETER	As opções da caixa de diálogo CONNDLG_RO_PATH e CONNDLG_USE_MRU estão definidas. (As opções da caixa de diálogo são especificadas pelo membro dwFlags da estrutura CONNECTDLGSTRUCT .) -ou- As opções da CONNDLG_PERSIST e da caixa de diálogo CONNDLG_NOT_PERSIST estão definidas. -ou- A opção da caixa de diálogo CONNDLG_RO_PATH está definida e o membro lpRemoteName da estrutura NETRESOURCE não aponta para uma rede remota. (A estrutura CONNECTDLGSTRUCT aponta para uma estrutura NETRESOURCE .)
ERROR_BAD_DEV_TYPE	O membro dwType da estrutura NETRESOURCE não está definido como RESOURCETYPE_DISK.
ERROR_BUSY	O provedor de rede está ocupado (possivelmente inicializando). O chamador deve tentar novamente.
ERROR_NO_NETWORK	A rede não está disponível.
ERROR_NOT_ENOUGH_MEMORY	Não há memória suficiente para exibir a caixa de diálogo.
ERROR_EXTENDED_ERROR	Ocorreu um erro específico da rede. Chame WNetGetLastError para obter uma descrição do erro.

Comentários

Observação

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


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]
Plataforma de Destino	Windows
Cabeçalho	winnetwk.h
Biblioteca	Mpr.lib
DLL	Mpr.dll