共用方式為

IFsiFileItem2：:p ut_IsRealTime 方法 (imapi2fs.h)

  • 發行項

設定檔案系統中檔案的 「即時」屬性。 這個屬性會指定在寫入或讀取時，內容是否需要最小數據傳輸速率，例如音訊和視訊數據。

語法

HRESULT put_IsRealTime(
  [in] VARIANT_BOOL newVal
);

參數

[in] newVal

指定 VARIANT_TRUE 以在檔案系統映射中設定檔案的 Real-Time 屬性;否則， VARIANT_FALSE。 預設值為 VARIANT_FALSE。

傳回值

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

傳回碼/值 Description
IMAPI_S_IMAGE_FEATURE_NOT_SUPPORTED
值：0x00AAB15FL
 目前文件系統修訂不支援此功能，因此，除非檔系統對象中啟用 UDF 修訂 2.01 或更高版本，否則檔案已標示為 Real-Time，但不會出現在結果檔案系統映射中。
IMAPI_E_PROPERTY_NOT_ACCESSIBLE
值：0xC0AAB160L
 屬性 '%1！ls！' 無法存取。
IMAPI_E_INVALID_PARAM
值：0xC0AAB101
 為參數 %1！ls！指定的值 無效。
 
注意 目前，使用這個方法設定 『Read Only』 檔案的 Real-Time 屬性值，因為 CreateResultImage 作業成功，所以會傳回S_OK。
 

備註

IFsiDirectoryItem：：AddTree 和 IFsiDirectoryItem2：：AddTreeWithNamedStreams 方法不會在將檔案新增至文件系統映射時設定 Real-Time 属性。 若要將檔案標示為即時檔案，必須在將檔案新增至文件系統映射之後加以列舉，並個別設定 Real-Time 屬性。

如果針對代表具名數據流的檔案專案叫用這個方法，此方法會傳回錯誤碼 IMAPI_E_PROPERTY_NOT_ACCESSIBLE ，因為具名數據流沒有 Real-Time 屬性。

Windows Server 2003 Service Pack 1 (SP1) 、Windows XP service Pack 2 (SP2) ，以及透過 Windows Feature Pack for Storage 支援此方法。 Windows 7 和 Windows Server 2008 R2 原生支援此更新套件所提供的所有功能。

規格需求

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

另請參閱

IFsiFileItem2