Windows Dev Center

Expand Minimize

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

Shlobj.h

Library

Shell32.lib

DLL

Shell32.dll

 

 

Community Additions

ADD
Show:
© 2015 Microsoft