SHOpenWithDialog-Funktion (shlobj_core.h)

  • Artikel

Zeigt das Dialogfeld Öffnen mit an.

Syntax

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

Parameter

[in, optional] hwndParent

Typ: HWND

Das Handle des übergeordneten Fensters. Dieser Wert kann NULL sein.

[in] poainfo

Typ: const OPENASINFO*

Ein Zeiger auf eine OPENASINFO-Struktur , die den Inhalt des resultierenden Dialogs angibt.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Ab Windows 10 werden die Flags OAIF_ALLOW_REGISTRATION, OAIF_FORCE_REGISTRATION und OAIF_HIDE_REGISTRATION von SHOpenWithDialog ignoriert. Das Dialogfeld Öffnen mit kann nicht mehr verwendet werden, um das Standardprogramm zum Öffnen einer Dateierweiterung zu ändern. Sie können nur SHOpenWithDialog verwenden, um eine einzelne Datei zu öffnen.

Wenn SHOpenWithDialog aufgerufen wird, ohne OAIF_EXEC zu übergeben, erhält der Benutzer ein Dialogfeld, in dem er darüber informiert, dass er die Standardprogramme ändern kann, die zum Öffnen von Dateierweiterungen in seinen Einstellungen verwendet werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlobj_core.h (einschließlich Shlobj.h)
Bibliothek Shell32.lib
DLL Shell32.dll
APIs ext-ms-win-shell-shell32-l1-2-1 (eingeführt in Windows 10, Version 10.0.10240)