Поделиться через

Функция WNetConnectionDialog1A (winnetwk.h)

Функция WNetConnectionDialog1 открывает общий диалог просмотра для подключения к сетевым ресурсам. Для установки параметров диалогового окна требуется connectDLGSTRUCT .

Синтаксис

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

Параметры

[in, out] lpConnDlgStruct

Указатель на структуру CONNECTDLGSTRUCT . Структура устанавливает параметры диалогового окна просмотра.

Возвращаемое значение

Если пользователь отменяет диалоговое окно, функция возвращает значение –1. Если функция выполнена успешно, она возвращает NO_ERROR. Кроме того, если вызов выполнен успешно, член dwDevNum структуры CONNECTDLGSTRUCT содержит номер подключенного устройства.

Обычно это диалоговое окно возвращает ошибку, только если пользователь не может ввести сеанс диалога. Это связано с тем, что ошибки, возникающие после сеанса диалога, передаются пользователю напрямую. Если функция завершается ошибкой, возвращаемое значение является системным кодом ошибки, например одним из следующих значений.

Возвращаемый код Description
ERROR_INVALID_PARAMETER
 Задаются параметры диалогового окна CONNDLG_RO_PATH и CONNDLG_USE_MRU. (Параметры диалогового окна задаются членом dwFlags структуры CONNECTDLGSTRUCT .)

–или–

Задаются параметры диалогового окна CONNDLG_PERSIST и CONNDLG_NOT_PERSIST.

–или–

Параметр диалогового окна CONNDLG_RO_PATH задан, а член lpRemoteName структуры NETRESOURCE не указывает на удаленную сеть. (Структура CONNECTDLGSTRUCT указывает на структуру NETRESOURCE .)
ERROR_BAD_DEV_TYPE
 Элемент dwType структуры NETRESOURCE не имеет значения RESOURCETYPE_DISK.
ERROR_BUSY
 Поставщик сети занят (возможно, инициализация). Вызывающий объект должен повторить попытку.
ERROR_NO_NETWORK
 Сеть недоступна.
ERROR_NOT_ENOUGH_MEMORY
 Для отображения диалогового окна недостаточно памяти.
ERROR_EXTENDED_ERROR
 Произошла ошибка, зависявшая от сети. Вызовите WNetGetLastError , чтобы получить описание ошибки.

Замечания

Замечание

Заголовок winnetwk.h определяет WNetConnectionDialog1 как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование Ценность
Минимальный поддерживаемый клиент Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер Windows 2000 Server [только классические приложения]
целевая платформа Виндоус
Header winnetwk.h
Library Mpr.lib
DLL Mpr.dll

См. также

CONNECTDLGSTRUCT

NETRESOURCE

WNetConnectionDialog

WNetDisconnectDialog

Обзор сети Windows (WNet)

Функции сети Windows

  • Last updated on