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 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 |
---|---|
|
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 .) |
|
O membro dwType da estrutura NETRESOURCE não está definido como RESOURCETYPE_DISK. |
|
O provedor de rede está ocupado (possivelmente inicializando). O chamador deve tentar novamente. |
|
A rede não está disponível. |
|
Não há memória suficiente para exibir a caixa de diálogo. |
|
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 |