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

Статья
11/20/2024

Запускает диалоговое окно типа контента 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 [только классические приложения]
целевая платформа	Виндоус
заголовка	intshcut.h
DLL	Url.dll

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