Функция SHStartNetConnectionDialogW (shlobj_core.h)

Статья
11/20/2024

[SHStartNetConnectionDialog доступен для использования в операционных системах, указанных в разделе "Требования". Он может быть изменен или недоступен в последующих версиях.]

Отображает общее диалоговое окно просмотра для подключения к сетевому ресурсу.

Синтаксис

SHSTDAPI SHStartNetConnectionDialogW(
  [in, optional] HWND    hwnd,
  [in, optional] LPCWSTR pszRemoteName,
                 DWORD   dwType
);

Параметры

[in, optional] hwnd

Тип: HWND

Дескриптор родительского окна.

[in, optional] pszRemoteName

Тип: LPCTSTR

Указатель на строку символов, завершающуюся значением NULL, которая указывает имя удаленной сети. Это значение можно задать для NULL.

dwType

Тип: DWORD

Битовое поле, содержащее набор флагов, определяющих тип ресурса, который установлен для поиска диалогового окна. Это значение может содержать одно из следующих значений, определенных в Winnetwk.h:

RESOURCETYPE_ANY (0x00000000)

Все ресурсы

RESOURCETYPE_DISK (0x00000001)

Ресурсы диска

RESOURCETYPE_PRINT (0x00000002)

Печать ресурсов

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

Тип: HRESULT

Всегда возвращает S_OK.

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	shlobj_core.h (include Shlobj.h, Shlobj_core.h)
библиотеки	Shell32.lib
DLL	Shell32.dll (версия 5.0 или более поздняя версия)

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