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 方法所傳回的值也可以在這裡傳回。
 

備註

這個方法會驗證多會話類型是否相容。 如果其中一個方法成功

除非媒體可覆寫 (，亦即 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