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


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

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

Синтаксис

SHSTDAPI SHOpenWithDialog(
  [in, optional] HWND             hwndParent,
  [in]           const OPENASINFO *poainfo
);

Параметры

[in, optional] hwndParent

Тип: HWND

Дескриптор родительского окна. Это значение может иметь значение NULL.

[in] poainfo

Тип: const OPENASINFO*

Указатель на структуру OPENASINFO , которая указывает содержимое результирующего диалогового окна.

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

Тип: HRESULT

Если эта функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Начиная с Windows 10 shOpenWithDialog игнорирует флаги OAIF_ALLOW_REGISTRATION, OAIF_FORCE_REGISTRATION и OAIF_HIDE_REGISTRATION. Диалоговое окно Открыть с помощью больше нельзя использовать для изменения программы по умолчанию, используемой для открытия расширения файла. С помощью SHOpenWithDialog можно открыть только один файл.

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

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header shlobj_core.h (включая Shlobj.h)
Библиотека Shell32.lib
DLL Shell32.dll
Набор API ext-ms-win-shell-shell32-l1-2-1 (представлено в Windows 10 версии 10.0.10240)