Função MIMEAssociationDialogW (intshcut.h)

  • Artigo

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

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

Sintaxe

INTSHCUTAPI HRESULT MIMEAssociationDialogW(
        HWND   hwndParent,
        DWORD  dwInFlags,
        PCWSTR pcszFile,
        PCWSTR pcszMIMEContentType,
  [out] PWSTR  pszAppBuf,
        UINT   ucAppBufLen
);

Parâmetros

hwndParent

Digite: 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 bit é o valor MIMEASSOCDLG_FL_REGISTER_ASSOC (0x0001). Se esse bit estiver definido, o aplicativo selecionado será registrado como o manipulador para o 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.

Retornar valor

Tipo: HRESULT

Nota 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, retornará S_OK se o tipo de conteúdo tiver sido 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.

Comentários

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.

Observação

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 de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

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