IStorage::SetElementTimes 方法 (objidl.h)

如果基礎文件系統支援這個方法, SetElementTimes 方法會設定指定儲存元素的修改、存取和建立時間。

語法

HRESULT SetElementTimes(
  [in] const OLECHAR  *pwcsName,
  [in] const FILETIME *pctime,
  [in] const FILETIME *patime,
  [in] const FILETIME *pmtime
);

參數

[in] pwcsName

要修改其時間的儲存物件項目名稱。 如果 為 NULL,則會在根記憶體上設定時間,而不是其中一個元素。

[in] pctime

如果建立時間未修改,則為元素的新建立時間或 NULL

[in] patime

專案的新存取時間,如果未修改存取時間,則為 NULL

[in] pmtime

如果修改時間未修改,則為 元素的新修改時間或 NULL

傳回值

這個方法可以傳回下列其中一個值。

傳回碼 描述
S_OK 已成功設定時間值。
E_PENDING 僅限異步記憶體:目前無法使用部分或所有元素的數據。
STG_E_ACCESSDENIED 呼叫端沒有足夠的許可權可變更專案。
STG_E_FILENOTFOUND 具有指定名稱的專案不存在。
STG_E_INSUFFICIENTMEMORY 元素因為記憶體不足而未變更。
STG_E_INVALIDNAME 不是項目名稱的有效值。
STG_E_INVALIDPOINTER 為專案指定的指標無效。
STG_E_INVALIDPARAMETER 其中一個參數無效。
STG_E_TOOMANYOPENFILES 元素未變更,因為有太多開啟的檔案。
STG_E_REVERTED 記憶體物件已因交易樹狀結構中上方的還原作業而失效。

備註

SetElementTimes 會 設定這個儲存物件內指定儲存元素的時間統計數據。

並非所有檔案系統都支援所有時間值。 這個方法會設定支援的那些時間,並忽略其餘時間。 每個時間值參數可以是 NULL;表示不應該進行任何修改。

呼叫 IStorage::Stat 方法來擷取這些時間值。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 objidl.h
程式庫 Uuid.lib
Dll Ole32.dll

另請參閱

IStorage - 複合檔案實作

IStorage::Stat