IFileSystemImage ::p ut_MultisessionInterfaces, méthode (imapi2fs.h)

Article
02/27/2024

Définit la liste des interfaces multisession pour le support optique.

Syntaxe

HRESULT put_MultisessionInterfaces(
  [in] SAFEARRAY *newVal
);

Paramètres

[in] newVal

Liste des interfaces multisession pour le support optique. Chaque élément de la liste est un VARIANT dont le type est VT_DISPATCH. Interrogez l’interface multisession pour son interface IDispatch et définissez le membre pdispVal de la variante sur l’interface IDispatch .

Valeur retournée

S_OK est retourné en cas de réussite, mais d’autres codes de réussite peuvent être retournés à la suite de l’implémentation. Les codes d’erreur suivants sont généralement retournés en cas d’échec de l’opération, mais ne représentent pas les seules valeurs d’erreur possibles :

Code de retour	Description
E_POINTER	Le pointeur n’est pas valide. Valeur : 0x80004003
IMAPI_E_INCOMPATIBLE_MULTISESSION_TYPE	IMAPI ne prend pas en charge le type multisession demandé. Valeur : 0xC0AAB15B
IMAPI_E_IMPORT_MEDIA_NOT_ALLOWED	IMAPI n’autorise pas les sessions multiples avec le type de média actuel. Valeur : 0xC0AAB159
IMAPI_E_NO_COMPATIBLE_MULTISESSION_TYPE	IMAPI ne prend en charge aucun des types multisession fournis sur le média actuel. Valeur : 0xC0AAB15C
IMAPI_E_BAD_MULTISESSION_PARAMETER	L’un des paramètres multisession ne peut pas être récupéré ou a une valeur incorrecte. Valeur : 0xC0AAB162
IMAPI_E_FSI_INTERNAL_ERROR	Une erreur interne s’est produite : %1 !ls !. Valeur : 0xC0AAB100
IMAPI_E_IMPORT_SEEK_FAILURE	Impossible de chercher à bloquer %1 ! I64d ! sur le disque source. Cette valeur est également retournée si le support optique est vide. Valeur : 0xC0AAB156

Note Les valeurs retournées par la méthode IUnknown ::QueryInterface peuvent également être retournées ici.

Remarques

Cette méthode valide que le type multisession est compatible. La méthode réussit si l’une des deux

La liste contient une seule interface IMultisession dérivée avec IMultisession ::p ut_InUse défini sur VARIANT_TRUE et si le type multisession est pris en charge sur le support actuel et pris en charge par l’implémentation IFileSystemImage .
La liste ne contient aucune interface IMultisession dérivée dont la propriété IMultisession ::p ut_InUse est définie sur VARIANT_TRUE, mais contient au moins une IMultisession dérivée prise en charge sur le support actuel et prise en charge par l’implémentation IFileSystemImage .

À moins que le média ne soit réinscriptible (c’est-à-dire DVD+/-RW, BD-RE, etc.), cette méthode échoue si le média est vide. Un échec se produit également si la liste contient plusieurs interfaces IMultisession dont la propriété IMultisession ::p ut_InUse est définie sur VARIANT_TRUE, ou si aucune interface IMultisession dérivée n’est prise en charge par l’implémentation IFileSystemImage . Actuellement, seule l’interface IMultisessionSequential qui dérive de IMultisession est prise en charge par l’implémentation IFileSystemImage .

Pour obtenir un exemple, consultez Création d’un disque multisession.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista, Windows XP avec SP2 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	imapi2fs.h

Voir aussi

IDiscFormat2Data ::get_MultisessionInterfaces

IFileSystemImage

IFileSystemImage ::get_MultisessionInterfaces

IMultisession

Partager via