Estrutura OPENASINFO (shlobj_core.h)

Armazena informações para a função SHOpenWithDialog .

Sintaxe

typedef struct _openasinfo {
  LPCWSTR            pcszFile;
  LPCWSTR            pcszClass;
  OPEN_AS_INFO_FLAGS oaifInFlags;
} OPENASINFO, *POPENASINFO;

Membros

pcszFile

Tipo: LPCWSTR

Um ponteiro para o nome do arquivo.

pcszClass

Tipo: LPCWSTR

Um ponteiro para a descrição do tipo de arquivo. Defina esse parâmetro como NULL para usar a extensão de nome de arquivo de pcszFile.

oaifInFlags

Tipo: OPEN_AS_INFO_FLAGS

As características da caixa de diálogo SHOpenWithDialog . Um ou mais dos valores a seguir.

OAIF_ALLOW_REGISTRATION (0x00000001)

Habilite a caixa de seleção "sempre usar este programa". Se não for passado, ele será desabilitado.

OAIF_REGISTER_EXT (0x00000002)

Faça o registro depois que o usuário pressionar o botão OK .

OAIF_EXEC (0x00000004)

Execute o arquivo após o registro.

OAIF_FORCE_REGISTRATION (0x00000008)

Force a caixa de seleção Sempre usar este programa a ser marcada. Normalmente, você não usará o sinalizador OAIF_ALLOW_REGISTRATION ao passar esse valor.

OAIF_HIDE_REGISTRATION (0x00000020)

Introduzido no Windows Vista. Oculte a caixa de seleção Sempre usar este programa . Se esse sinalizador for especificado, os sinalizadores OAIF_ALLOW_REGISTRATION e OAIF_FORCE_REGISTRATION serão ignorados.

OAIF_URL_PROTOCOL (0x00000040)

Introduzido no Windows Vista. O valor da extensão passada é, na verdade, um protocolo, portanto, a caixa de diálogo Abrir com deve mostrar aplicativos registrados como capazes de lidar com esse protocolo.

OAIF_FILE_IS_URI (0x00000080)

Introduzido no Windows 8. O local apontado pelo parâmetro pcszFile é fornecido como um URI.

Comentários

A partir do 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.

Requisitos

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]
Cabeçalho	shlobj_core.h (inclua Shlobj.h)