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 值，如下所示：

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

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

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

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