Metodo IFileSystemImage::p ut_MultisessionInterfaces (imapi2fs.h)

Articolo
02/27/2024

Imposta l'elenco di interfacce multi-sessione per i supporti ottici.

Sintassi

HRESULT put_MultisessionInterfaces(
  [in] SAFEARRAY *newVal
);

Parametri

[in] newVal

Elenco delle interfacce multi-sessione per i supporti ottici. Ogni elemento dell'elenco è un VARIANT il cui tipo è VT_DISPATCH. Eseguire una query sull'interfaccia multi-sessione per l'interfaccia IDispatch e impostare il membro pdispVal della variante sull'interfaccia IDispatch.

Valore restituito

S_OK viene restituito in caso di esito positivo, ma altri codici di esito positivo possono essere restituiti in seguito all'implementazione. I codici di errore seguenti vengono comunemente restituiti in caso di errore dell'operazione, ma non rappresentano gli unici valori di errore possibili:

Codice restituito	Descrizione
E_POINTER	Puntatore non valido. Valore: 0x80004003
IMAPI_E_INCOMPATIBLE_MULTISESSION_TYPE	IMAPI non supporta il tipo multisessione richiesto. Valore: 0xC0AAB15B
IMAPI_E_IMPORT_MEDIA_NOT_ALLOWED	IMAPI non consente la multi-sessione con il tipo di supporto corrente. Valore: 0xC0AAB159
IMAPI_E_NO_COMPATIBLE_MULTISESSION_TYPE	IMAPI supporta nessuno dei tipi multisessione forniti nel supporto corrente. Valore: 0xC0AAB15C
IMAPI_E_BAD_MULTISESSION_PARAMETER	Uno dei parametri multisessione non può essere recuperato o ha un valore errato. Valore: 0xC0AAB162
IMAPI_E_FSI_INTERNAL_ERROR	Errore interno si è verificato: %1!ls!. Valore: 0xC0AAB100
IMAPI_E_IMPORT_SEEK_FAILURE	Impossibile cercare di bloccare %1! I64d! nel disco di origine. Questo valore viene restituito anche se il supporto ottico è vuoto. Valore: 0xC0AAB156

Nota I valori restituiti dal metodo IUnknown::QueryInterface possono essere restituiti anche qui.

Commenti

Questo metodo convalida che il tipo di sessione multipla sia compatibile. Il metodo ha esito positivo se uno dei due

L'elenco contiene un'unica interfaccia IMultisession derivata con IMultisession::p ut_InUse impostata su VARIANT_TRUE e se il tipo di sessione multipla è supportato nel supporto corrente e supportato dall'implementazione IFileSystemImage .
L'elenco non contiene interfacce IMultisession derivate la cui proprietà IMultisession::p ut_InUse è impostata su VARIANT_TRUE, ma contiene almeno un IMultisession derivato supportato nei supporti correnti e supportato dall'implementazione di IFileSystemImage .

A meno che il supporto non sia sovrascrivibile (ad esempio DVD+/-RW, BD-RE e così via), questo metodo avrà esito negativo se il supporto è vuoto. L'errore si verifica anche se l'elenco contiene più di un'interfaccia IMultisession la cui proprietà IMultisession::p ut_InUse è impostata su VARIANT_TRUE o nessuna interfaccia IMultisession derivata è supportata dall'implementazione di IFileSystemImage . Attualmente, solo l'interfaccia IMultisessionSequential che deriva da IMultisession è supportata dall'implementazione IFileSystemImage .

Per un esempio, vedere Creazione di un disco multisessione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP2 [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	imapi2fs.h

Vedi anche

IDiscFormat2Data::get_MultisessionInterfaces

IFileSystemImage

IFileSystemImage::get_MultisessionInterfaces

IMultisession

Condividi tramite