SHOpenWithDialog function
Displays the Open With dialog box.
Syntax
HRESULT SHOpenWithDialog(
_In_opt_ HWND hwndParent,
_In_ const OPENASINFO *poainfo
);
Parameters
- hwndParent [in, optional]
-
Type: HWND
The handle of the parent window. This value can be NULL.
- poainfo [in]
-
Type: const OPENASINFO*
A pointer to an OPENASINFO structure, which specifies the contents of the resulting dialog.
Return value
Type: HRESULT
If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
Starting in Windows 10, the OAIF_ALLOW_REGISTRATION, OAIF_FORCE_REGISTRATION, and OAIF_HIDE_REGISTRATION flags will be ignored by SHOpenWithDialog. The Open With dialog box can no longer be used to change the default program used to open a file extension. You can only use SHOpenWithDialog to open a single file.
If SHOpenWithDialog is called without passing OAIF_EXEC, the user will receive a dialog that informs them that they can change the default programs used to open file extensions in their Settings.
Requirements
|
Minimum supported client |
Windows Vista [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2008 [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|