FltCheckAndGrowNameControl 函式（fltkernel.h）

FltCheckAndGrowNameControl 例程會檢查 FLT_NAME_CONTROL 結構中的緩衝區是否夠大，足以保存指定的位元元組數目。如果沒有，FltCheckAndGrowNameControl 會將它取代為較大的系統配置緩衝區。

語法

NTSTATUS FLTAPI FltCheckAndGrowNameControl(
  [in, out] PFLT_NAME_CONTROL NameCtrl,
  [in]      USHORT            NewSize
);

[in, out] NameCtrl

包含檔名資訊的 FLT_NAME_CONTROL 結構的指標。

[in] NewSize

新名稱控制緩衝區的必要大小，以位元組為單位。

FltCheckAndGrowNameControl 會傳回STATUS_SUCCESS或適當的 NTSTATUS 值，如下所示：

傳回碼	描述
STATUS_INSUFFICIENT_RESOURCES	可用集區中的記憶體不足，無法滿足要求。

迷你篩選驅動程式不得直接嘗試釋放或取代 NameFLT_NAME_CONTROL 成員中的緩衝區。相反地，小型篩選驅動程式應該呼叫 FltCheckAndGrowNameControl，以取得較大的名稱緩衝區。

如果 NameCtrl 結構中緩衝區的大小小於 newSize 參數的值，FltCheckAndGrowNameControl 會將其取代為較大的系統配置緩衝區。 FltCheckAndGrowNameControl 會將舊緩衝區的內容複製到新的緩衝區，並釋放舊的緩衝區。

如果 NameCtrl 結構中緩衝區的大小大於或等於 newSize 參數的值，FltCheckAndGrowNameControl 會傳回STATUS_SUCCESS且不會取代緩衝區。