StgSetTimes 函式 (coml2api.h)

如果基礎文件系統支援， StgSetTimes 函式會設定所指示檔案的建立、存取和修改時間。

語法

HRESULT StgSetTimes(
  [in] const WCHAR    *lpszName,
  [in] const FILETIME *pctime,
  [in] const FILETIME *patime,
  [in] const FILETIME *pmtime
);

參數

[in] lpszName

要變更之檔名的指標。

[in] pctime

建立時間之新值的指標。

[in] patime

存取時間之新值的指標。

[in] pmtime

修改時間之新值的指標。

傳回值

StgSetTimes 函式也可以傳回任何文件系統錯誤或包裝在 HRESULT 中的系統錯誤。 請參閱 錯誤處理策略 和 處理未知的錯誤。

備註

StgSetTimes 函式會設定指定檔案的時間值。 每個時間值參數可以是 NULL，表示不應該進行任何修改。

基礎文件系統可能不支援其中一或多個時間值。 此函式會設定可以設定和忽略其餘的時間。

規格需求