FwpsAcquireClassifyHandle0 函式（fwpsk.h）

FwpsAcquireClassifyHandle0 函式會產生分類句柄，用來識別可寫入層數據的異步分類作業和要求。

NoteFwpsAcquireClassifyHandle0 是 FwpsAcquireClassifyHandle 的特定版本。如需詳細資訊，請參閱糧食計劃署 Version-Independent 名稱和以特定版本的 Windows 為目標。

語法

NTSTATUS FwpsAcquireClassifyHandle0(
  [in]  void   *classifyContext,
  [in]  UINT32 flags,
  [out] UINT64 *classifyHandle
);

[in] classifyContext

來自 classifyFn1的 classifyContext 參數。 WFP 引擎會將此值傳遞至圖說文字驅動程式的分類Fn。

[in] flags

保留供日後使用。設定為 0。

[out] classifyHandle

接收分類句柄之變數的指標。後續的函式呼叫需要此句柄，如中所述。

FwpsAcquireClassifyHandle0 函式會傳回下列其中一個 NTSTATUS 代碼。

傳回碼	描述
STATUS_SUCCESS	已成功傳回分類要求的句柄。 classifyHandle 參數指向的變數，其中包含分類要求的句柄。
其他狀態代碼	發生錯誤。

FwpsAcquireClassifyHandle0 是異步分類和數據修改的支援函式。此函式傳回的句柄需要做為下列函式的參數：

對於此函式的每個呼叫，圖說驅動程式必須呼叫 FwpsReleaseClassifyHandle0，以釋放與句柄相關聯的系統資源。