IFileSystemImage：:p ut_MultisessionInterfaces 方法 (imapi2fs.h)

設定光學媒體的多會話介面清單。

語法

HRESULT put_MultisessionInterfaces(
  [in] SAFEARRAY *newVal
);

參數

[in] newVal

光學媒體的多會話介面清單。 清單的每個元素都是 VARIANT，其類型為 VT_DISPATCH。 查詢其 IDispatch 介面的多會話介面，並將 variant 的 pdispVal 成員設定為 IDispatch 介面。

傳回值

成功時會傳回S_OK，但可能會因為實作而傳回其他成功碼。 下列錯誤碼通常會在作業失敗時傳回，但不代表唯一可能的錯誤值：

傳回碼	Description
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，或 IFileSystemImage 實作不支援衍生的 IMultisession 介面，也會發生失敗。 目前，IFileSystemImage 實作僅支援衍生自 IMultisession 的 IMultisessionSequential 介面。

如需範例，請參閱 建立多磁碟區磁碟區。

規格需求

需求	值
最低支援的用戶端	Windows Vista、Windows XP 與 SP2 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	imapi2fs.h

另請參閱

IDiscFormat2Data：：get_MultisessionInterfaces

IFileSystemImage

IFileSystemImage：：get_MultisessionInterfaces

IMultisession