Поделиться через

Функция MIMEAssociationDialogA (intshcut.h)

  • Статья

Запускает диалоговое окно незарегистрированного типа контента MIME.

Примечание Windows XP с пакетом обновления 2 (SP2) или более поздней версии: эта функция больше не поддерживается.
 

Синтаксис

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

Параметры

hwndParent

Тип: HWND

Дескриптор родительского окна всех опубликованных дочерних окон.

dwInFlags

Тип: DWORD

Значение битового флага, указывающее, должна ли быть зарегистрирована связь. Флаг бита — это значение MIMEASSOCDLG_FL_REGISTER_ASSOC (0x0001). Если этот бит задан, выбранное приложение регистрируется в качестве обработчика для заданного типа MIME. Если этот бит ясен, связь не регистрируется.

Приложение регистрируется только в том случае, если этот флаг установлен и пользователь указывает, что требуется создать постоянную связь.

Регистрация невозможна, если строка в pcszFile не содержит расширения.

pcszFile

Тип: PCTSTR

Адрес строки со значением NULL, содержащей имя целевого файла. Этот файл должен соответствовать типу содержимого, описанному параметром pcszMIMEContentType .

pcszMIMEContentType

Тип: PCTSTR

Адрес строки, завершающейся значением NULL, которая содержит незарегистрированный тип контента.

[out] pszAppBuf

Тип: PTSTR

Указатель на буфер, который при успешном возврате этой функции получает путь к приложению, указанный пользователем.

ucAppBufLen

Тип: UINT

Размер pszAppBuf в символах.

Возвращаемое значение

Тип: HRESULT

Примечание В Windows XP с пакетом обновления 2 (SP2) эта функция не поддерживается и возвращает E_NOTIMPL во всех ситуациях.
 
В поддерживаемых системах возвращает S_OK, если тип контента был успешно связан с расширением. В этом случае расширение связывается как значение по умолчанию для типа контента, а pszAppBuf указывает на строку, содержащую путь к указанному приложению. Функция возвращает S_FALSE, если ничего не было зарегистрировано. В противном случае возвращаемое значение будет иметь одно из следующих значений:
Код возврата Описание
E_ABORT
 Пользователь отменил операцию.
E_FLAGS
 Недопустимая комбинация флагов, переданная в dwInFlags .
E_OUTOFMEMORY
 Недостаточно доступной памяти для завершения операции.
E_POINTER
 Один из входных указателей недопустим.

Комментарии

Эта функция не проверяет синтаксис строки входного типа контента в pcszMIMEContentType. Успешное возвращаемое значение не указывает, что указанный тип контента MIME является допустимым.

Примечание

Заголовок intshcut.h определяет MIMEAssociationDialog в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header intshcut.h
DLL Url.dll