共用方式為


CcSetCacheFileSizes 函式 (ntifs.h)

CcSetCacheFileSizes 函式會依區段對象指標來設定快取管理員檔案大小。

語法

NTSTATUS CcSetCacheFileSizes(
  [in] PSECTION_OBJECT_POINTERS SectionObjectPointer,
  [in] PCC_FILE_SIZES           FileSizes
);

參數

[in] SectionObjectPointer

包含區段對象資訊的 SECTION_OBJECT_POINTERS 結構的指標。

[in] FileSizes

指定要設定之檔案大小的 CC_FILE_SIZES 結構的指標。

傳回值

CcSetCacheFileSizes 會在檔案大小成功變更時傳回STATUS_SUCCESS,如果清除成功,則傳回 。 否則,它會傳回非成功的 NSTATUS 程式代碼,例如 STATUS_INSUFFICIENT_RESOURCES,而且可能會引發狀態例外狀況。

關於在錯誤時引發狀態例外狀況:

  • 如果作業造成 CcSetCacheFileSizes 排清及/或清除檔案, CcSetCacheFileSizes 將不會在錯誤時引發;它只會傳回排清或清除作業的適當非成功NTSTATUS程式代碼。

  • 如果作業造成 CcSetCacheFileSizes 擴充區段, 則 CcSetCacheFileSizes 將會在此延伸模組期間遇到任何錯誤時引發。

備註

如果作業造成 CcSetCacheFileSizes 擴充區段且發生失敗, CcSetCacheFileSizes 就會引發該特定失敗的狀態例外狀況。 例如,如果發生集區配置失敗, CcSetCacheFileSizes 會引發STATUS_INSUFFICIENT_RESOURCES例外狀況。 因此,若要控制是否發生失敗,驅動程式應該在 try-excepttry-finally 語句中包裝對 CcSetCacheFileSizes 的呼叫。

文件系統必須確定快取對應有效,而且會在此呼叫期間維持此狀態。

若要取得快取檔案的大小,請將 SectionObjectPointer 傳遞至 CcGetCacheFileSize

規格需求

需求
最低支援的用戶端 Windows 11 版本 22H2
標頭 ntifs.h

另請參閱

CcGetCacheFileSize

CcSetFileSizesEx