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-finally 語句 try-except 或 try-finally 語句中包裝對 ccSetCacheFileSizes 的呼叫。

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

若要取得快取檔案的大小，請將 sectionObjectPointer 傳遞至 CcGetCacheFileSize。

要求

另請參閱

CcGetCacheFileSize

CcSetFileSizesEx