Метод IFileSystemImage::p ut_MultisessionInterfaces (imapi2fs.h)

Статья
08/24/2023

Задает список многосеансовых интерфейсов для оптического носителя.

Синтаксис

HRESULT put_MultisessionInterfaces(
  [in] SAFEARRAY *newVal
);

Параметры

[in] newVal

Список многосеансовых интерфейсов для оптического носителя. Каждый элемент списка является variant, тип которого VT_DISPATCH. Запросите многосеансовый интерфейс для интерфейса IDispatch и задайте для элемента pdispVal варианта интерфейс IDispatch .

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

S_OK возвращается при успешном выполнении, но в результате реализации могут быть возвращены другие коды успешного выполнения. Следующие коды ошибок обычно возвращаются при сбое операции, но не представляют единственные возможные значения ошибок:

Код возврата	Описание
E_POINTER	Недопустимый указатель. Значение: 0x80004003
IMAPI_E_INCOMPATIBLE_MULTISESSION_TYPE	IMAPI не поддерживает запрошенный тип мультисессии. Значение: 0xC0AAB15B
IMAPI_E_IMPORT_MEDIA_NOT_ALLOWED	IMAPI не допускает многосеансовый режим с текущим типом мультимедиа. Значение: 0xC0AAB159
IMAPI_E_NO_COMPATIBLE_MULTISESSION_TYPE	IMAPI не поддерживает ни один из типов мультисессии, предоставляемых на текущем носителе. Значение: 0xC0AAB15C
IMAPI_E_BAD_MULTISESSION_PARAMETER	Один из параметров нескольких параметров не может быть получен или имеет неправильное значение. Значение: 0xC0AAB162
IMAPI_E_FSI_INTERNAL_ERROR	Произошла внутренняя ошибка: %1!ls!. Значение: 0xC0AAB100
IMAPI_E_IMPORT_SEEK_FAILURE	Не удается заблокировать %1! I64d! на исходном диске. Это значение также возвращается, если оптический носитель пуст. Значение: 0xC0AAB156

Примечание Здесь также могут возвращаться значения, возвращаемые методом IUnknown::QueryInterface.

Список содержит один производный интерфейс IMultisession с IMultisession::p ut_InUse , для которой задано значение VARIANT_TRUE и если многосеансовый тип поддерживается на текущем носителе и поддерживается реализацией IFileSystemImage .
Список не содержит производных интерфейсов IMultisession , свойство IMultisession::p ut_InUse которых имеет значение VARIANT_TRUE, но содержит по крайней мере одно производное IMultisession , поддерживаемое на текущем носителе и поддерживаемое реализацией IFileSystemImage .

Если носитель не перезаписан (например, DVD+/-RW, BD-RE и т. д.), этот метод завершится ошибкой, если носитель пуст. Сбой также возникнет, если список содержит несколько интерфейсов IMultisession , для которых свойство IMultisession::p ut_InUse имеет значение VARIANT_TRUE или ни один производный интерфейс IMultisession не поддерживается реализацией IFileSystemImage . В настоящее время реализацией IFileSystemImage поддерживается только интерфейс IMultisessionSequential, производный от IMultisession.

Пример см. в разделе Создание многосессийного диска.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista, Windows XP с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	imapi2fs.h

См. также раздел

IDiscFormat2Data::get_MultisessionInterfaces

IFileSystemImage

IFileSystemImage::get_MultisessionInterfaces

IMultisession

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