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

Статья
08/27/2023

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

Синтаксис

DWORD WNetConnectionDialog1A(
  [in, out] LPCONNECTDLGSTRUCTA 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 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winnetwk.h
Библиотека	Mpr.lib
DLL	Mpr.dll