Função MIMEAssociationDialogA (intshcut.h)

Artigo
11/20/2024

Executa a caixa de diálogo de tipo de conteúdo MIME não registrado.

Observação Windows XP Service Pack 2 (SP2) ou posterior: essa função não tem mais suporte.

Sintaxe

INTSHCUTAPI HRESULT MIMEAssociationDialogA(
        HWND  hwndParent,
        DWORD dwInFlags,
        PCSTR pcszFile,
        PCSTR pcszMIMEContentType,
  [out] PSTR  pszAppBuf,
        UINT  ucAppBufLen
);

Parâmetros

hwndParent

Tipo: HWND

Um identificador para a janela pai de qualquer janela filho postada.

dwInFlags

Tipo: DWORD

Um valor de sinalizador de bit que especifica se uma associação deve ser registrada. O sinalizador de bits é o valor MIMEASSOCDLG_FL_REGISTER_ASSOC (0x0001). Se esse bit for definido, o aplicativo selecionado será registrado como o manipulador do tipo MIME fornecido. Se esse bit estiver claro, nenhuma associação será registrada.

Um aplicativo será registrado somente se esse sinalizador estiver definido e o usuário indicar que uma associação persistente deverá ser feita.

O registro será impossível se a cadeia de caracteres em pcszFile não contiver uma extensão.

pcszFile

Tipo: PCTSTR

O endereço de uma cadeia de caracteres terminada em nulo que contém o nome do arquivo de destino. Esse arquivo deve estar em conformidade com o tipo de conteúdo descrito pelo parâmetro pcszMIMEContentType.

pcszMIMEContentType

Tipo: PCTSTR

O endereço de uma cadeia de caracteres terminada em nulo que contém o tipo de conteúdo não registrado.

[out] pszAppBuf

Tipo: PTSTR

Um ponteiro para um buffer que, quando essa função retorna com êxito, recebe o caminho do aplicativo especificado pelo usuário.

ucAppBufLen

Tipo: UINT

Tamanho de pszAppBuf , em caracteres.

Valor de retorno

Tipo: HRESULT

Observação A partir do Windows XP SP2, essa função não tem suporte e retorna E_NOTIMPL em todas as situações.

Em sistemas com suporte, retorna S_OK se o tipo de conteúdo foi associado com êxito à extensão. Nesse caso, a extensão é associada como o padrão para o tipo de conteúdo e pszAppBuf aponta para a cadeia de caracteres que contém o caminho do aplicativo especificado. A função retornará S_FALSE se nada tiver sido registrado. Caso contrário, o valor retornado será um dos seguintes:

Código de retorno	Descrição
E_ABORT	O usuário cancelou a operação.
E_FLAGS	A combinação de sinalizadores passada em dwInFlags é inválida.
E_OUTOFMEMORY	Não havia memória suficiente disponível para concluir a operação.
E_POINTER	Um dos ponteiros de entrada é inválido.

Observações

Essa função não valida a sintaxe da cadeia de caracteres de tipo de conteúdo de entrada em pcszMIMEContentType. Um valor retornado bem-sucedido não indica que o tipo de conteúdo MIME especificado é válido.

Nota

O cabeçalho intshcut.h define MIMEAssociationDialog como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	intshcut.h
de DLL	Url.dll

Compartilhar via