Método IFileSystemImage::p ut_MultisessionInterfaces (imapi2fs.h)

Define a lista de interfaces de várias sessões para a mídia óptica.

Sintaxe

HRESULT put_MultisessionInterfaces(
  [in] SAFEARRAY *newVal
);

Parâmetros

[in] newVal

Lista de interfaces de várias sessões para a mídia óptica. Cada elemento da lista é um VARIANT cujo tipo é VT_DISPATCH. Consulte a interface de várias sessões para sua interface IDispatch e defina o membro pdispVal da variante para a interface IDispatch .

Retornar valor

S_OK é retornado com êxito, mas outros códigos de êxito podem ser retornados como resultado da implementação. Os seguintes códigos de erro normalmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:

Código de retorno	Descrição
E_POINTER	O ponteiro não é válido. Valor: 0x80004003
IMAPI_E_INCOMPATIBLE_MULTISESSION_TYPE	O IMAPI não dá suporte ao tipo de multissessão solicitado. Valor: 0xC0AAB15B
IMAPI_E_IMPORT_MEDIA_NOT_ALLOWED	O IMAPI não permite várias sessões com o tipo de mídia atual. Valor: 0xC0AAB159
IMAPI_E_NO_COMPATIBLE_MULTISESSION_TYPE	O IMAPI não dá suporte a nenhum dos tipos de multissessão fornecidos na mídia atual. Valor: 0xC0AAB15C
IMAPI_E_BAD_MULTISESSION_PARAMETER	Um dos parâmetros de multissessão não pode ser recuperado ou tem um valor incorreto. Valor: 0xC0AAB162
IMAPI_E_FSI_INTERNAL_ERROR	Erro interno: %1!ls!. Valor: 0xC0AAB100
IMAPI_E_IMPORT_SEEK_FAILURE	Não é possível tentar bloquear %1! I64d! no disco de origem. Esse valor também será retornado se a mídia óptica estiver em branco. Valor: 0xC0AAB156

 

Nota Os valores retornados pelo método IUnknown::QueryInterface também podem ser retornados aqui.

 

Comentários

Esse método valida se o tipo de várias sessões é compatível. O método terá êxito se um dos dois

• A lista contém uma única interface IMultisession derivada com IMultisession::p ut_InUse definida como VARIANT_TRUE e se o tipo de várias sessões tiver suporte na mídia atual e tiver suporte na implementação IFileSystemImage .
• A lista não contém interfaces IMultisession derivadas cuja propriedade IMultisession::p ut_InUse está definida como VARIANT_TRUE, mas contém pelo menos uma IMultisession derivada com suporte na mídia atual e compatível com a implementação IFileSystemImage .

A menos que a mídia seja sobrescrita (ou seja, DVD+/-RW, BD-RE etc.), esse método falhará se a mídia estiver em branco. A falha também ocorrerá se a lista contiver mais de uma interface IMultisession cuja propriedade IMultisession::p ut_InUse estiver definida como VARIANT_TRUE ou nenhuma interface IMultisession derivada tiver suporte da implementação IFileSystemImage . Atualmente, somente a interface IMultisessionSequential derivada de IMultisession é compatível com a implementação IFileSystemImage .

Para obter um exemplo, consulte Criando um disco multissessão.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	imapi2fs.h

Confira também

IDiscFormat2Data::get_MultisessionInterfaces

IFileSystemImage

IFileSystemImage::get_MultisessionInterfaces

IMultisession