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

Статья
11/20/2024

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

Синтаксис

DWORD WNetConnectionDialog1W(
  [in, out] LPCONNECTDLGSTRUCTW lpConnDlgStruct
);

Параметры

[in, out] lpConnDlgStruct

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

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

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

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

Возвращаемый код	Описание
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 [только классические приложения]
целевая платформа	Виндоус
заголовка	winnetwk.h
библиотеки	Mpr.lib
DLL	Mpr.dll