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

Статья
08/26/2023

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

Проверяет UNC-путь путем вызова WNetAddConnection3. Функция позволяет пользователю ввести UNC-приложение или имя документа удаленного сетевого доступа (RNA) в диалоговом окне Выполнить в меню Пуск .

Синтаксис

BOOL SHValidateUNC(
  [in, optional] HWND  hwndOwner,
  [in, out]      PWSTR pszFile,
                 UINT  fConnect
);

Параметры

[in, optional] hwndOwner

Тип: HWND

Дескриптор родительского окна, используемый для отображения пользовательского интерфейса. Если это не требуется, это значение может быть равно NULL.

[in, out] pszFile

Тип: PWSTR

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

fConnect

Тип: UINT

Одно или несколько из следующих значений.

VALIDATEUNC_CONNECT (0x0001)

Соедините букву диска. Если этот флаг установлен, значение в pszFile изменяется на локальный диск, с которым сопоставляется UNC на локальном компьютере.

VALIDATEUNC_NOUI (0x0002)

При сбое или успешном выполнении не отображается пользовательский интерфейс.

VALIDATEUNC_PRINT (0x0004)

Проверьте как общую папку печати, а не как общую папку на диске.

VALIDATEUNC_PERSIST (0x0008)

Windows Vista и более поздних версий. Подключение должно быть постоянным.

VALIDATEUNC_VALID

Значение маски, используемое для проверки допустимости флагов, передаваемых в SHValidateUNC .

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

Тип: BOOL

Возвращает значение TRUE , если UNC-путь существует; FALSE , если UNC-путь не существует или если произошел сбой.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	shlobj_core.h (включая Shlobj.h)
Библиотека	Shell32.lib
DLL	Shell32.dll (версия 5.00 или более поздняя)

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