Função SHOpenWithDialog (shlobj_core.h)

  • Artigo

Exibe a caixa de diálogo Abrir com .

Sintaxe

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

Parâmetros

[in, optional] hwndParent

Digite: HWND

O identificador da janela pai. Esse valor pode ser NULL.

[in] poainfo

Tipo: const OPENASINFO*

Um ponteiro para uma estrutura OPENASINFO , que especifica o conteúdo da caixa de diálogo resultante.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

A partir de Windows 10, os sinalizadores OAIF_ALLOW_REGISTRATION, OAIF_FORCE_REGISTRATION e OAIF_HIDE_REGISTRATION serão ignorados por SHOpenWithDialog. A caixa de diálogo Abrir com não pode mais ser usada para alterar o programa padrão usado para abrir uma extensão de arquivo. Você só pode usar SHOpenWithDialog para abrir um único arquivo.

Se SHOpenWithDialog for chamado sem passar OAIF_EXEC, o usuário receberá uma caixa de diálogo informando que pode alterar os programas padrão usados para abrir extensões de arquivo em suas Configurações.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlobj_core.h (inclua Shlobj.h)
Biblioteca Shell32.lib
DLL Shell32.dll
Conjunto de APIs ext-ms-win-shell-shell32-l1-2-1 (introduzido no Windows 10, versão 10.0.10240)