IFileSystemImage::p ut_MultisessionInterfaces-Methode (imapi2fs.h)

Artikel
08/24/2023

Legt die Liste der Schnittstellen mit mehreren Sitzungen für die optischen Medien fest.

Syntax

HRESULT put_MultisessionInterfaces(
  [in] SAFEARRAY *newVal
);

Parameter

[in] newVal

Liste der Schnittstellen mit mehreren Sitzungen für die optischen Medien. Jedes Element der Liste ist ein VARIANT-Element, dessen Typ VT_DISPATCH ist. Fragen Sie die Multisitzungsschnittstelle für ihre IDispatch-Schnittstelle ab, und legen Sie den pdispVal-Member der Variante auf die IDispatch-Schnittstelle fest.

Rückgabewert

S_OK wird bei Erfolg zurückgegeben, aber andere Erfolgscodes können als Ergebnis der Implementierung zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Vorgangsfehlern zurückgegeben, stellen aber nicht die einzigen möglichen Fehlerwerte dar:

Rückgabecode	Beschreibung
E_POINTER	Der Zeiger ist ungültig. Wert: 0x80004003
IMAPI_E_INCOMPATIBLE_MULTISESSION_TYPE	IMAPI unterstützt den angeforderten Multisessiontyp nicht. Wert: 0xC0AAB15B
IMAPI_E_IMPORT_MEDIA_NOT_ALLOWED	IMAPI lässt keine Multisitzungen mit dem aktuellen Medientyp zu. Wert: 0xC0AAB159
IMAPI_E_NO_COMPATIBLE_MULTISESSION_TYPE	IMAPI unterstützt keinen der Multisessiontypen, die auf den aktuellen Medien bereitgestellt werden. Wert: 0xC0AAB15C
IMAPI_E_BAD_MULTISESSION_PARAMETER	Einer der Multisessionparameter kann nicht abgerufen werden oder weist einen falschen Wert auf. Wert: 0xC0AAB162
IMAPI_E_FSI_INTERNAL_ERROR	Interner Fehler: %1!ls!. Wert: 0xC0AAB100
IMAPI_E_IMPORT_SEEK_FAILURE	%1 kann nicht blockiert werden! I64d! auf dem Quelldatenträger. Dieser Wert wird auch zurückgegeben, wenn das optische Medium leer ist. Wert: 0xC0AAB156

Hinweis Werte, die von der IUnknown::QueryInterface-Methode zurückgegeben werden, können auch hier zurückgegeben werden.

Hinweise

Diese Methode überprüft, ob der Typ mit mehreren Sitzungen kompatibel ist. Die Methode ist erfolgreich, wenn

Die Liste enthält eine einzelne abgeleitete IMultisession-Schnittstelle , wobei IMultisession::p ut_InUse auf VARIANT_TRUE festgelegt ist und wenn der Multisitzungstyp auf den aktuellen Medien unterstützt und von der IFileSystemImage-Implementierung unterstützt wird.
Die Liste enthält keine abgeleiteten IMultisession-Schnittstellen , deren IMultisession::p ut_InUse-Eigenschaft auf VARIANT_TRUE festgelegt ist, enthält aber mindestens eine abgeleitete IMultisession , die auf aktuellen Medien unterstützt und von der IFileSystemImage-Implementierung unterstützt wird.

Sofern die Medien nicht überschreibbar sind (d. h. DVD+/-RW, BD-RE usw.), schlägt diese Methode fehl, wenn das Medium leer ist. Ein Fehler tritt auch auf, wenn die Liste mehr als eine IMultisession-Schnittstelle enthält, deren IMultisession::p ut_InUse-Eigenschaft auf VARIANT_TRUE festgelegt ist, oder wenn keine abgeleitete IMultisession-Schnittstelle von der IFileSystemImage-Implementierung unterstützt wird. Derzeit wird nur die IMultisessionSequential-Schnittstelle , die von IMultisession abgeleitet ist, von der IFileSystemImage-Implementierung unterstützt.

Ein Beispiel finden Sie unter Erstellen eines Multisession-Datenträgers.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	imapi2fs.h

Weitere Informationen

IDiscFormat2Data::get_MultisessionInterfaces

IFileSystemImage

IFileSystemImage::get_MultisessionInterfaces

IMultisession