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 |