Função WNetConnectionDialog1A (winnetwk.h)

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 de CONNECTDLGSTRUCT . A estrutura estabelece os parâmetros de diálogo de navegação.

Valor de retorno

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 dwDevNum membro da estrutura CONNECTDLGSTRUCT contém o número do dispositivo conectado.

Normalmente, essa caixa de diálogo retornará 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 caixa de diálogo CONNDLG_PERSIST e CONNDLG_NOT_PERSIST estão definidas. -ou- A opção da caixa de diálogo CONNDLG_RO_PATH está definida e o lpRemoteName membro da estrutura NETRESOURCE não aponta para uma rede remota. (A estrutura CONNECTDLGSTRUCT aponta para uma estrutura NETRESOURCE.)
ERROR_BAD_DEV_TYPE	O dwType membro da estrutura de 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.

Observações

Nota

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 do 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]
da Plataforma de Destino	Windows
cabeçalho	winnetwk.h
biblioteca	Mpr.lib
de DLL	Mpr.dll

Consulte também

CONNECTDLGSTRUCT

NETRESOURCE

WNetConnectionDialog

WNetDisconnectDialog

Visão geral WNet (Rede windows)

funções de rede do Windows