FwpsAcquireClassifyHandle0 函式 (fwpsk.h)

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

注意FwpsAcquireClassifyHandle0 是特定版本的 FwpsAcquireClassifyHandle。如需詳細資訊，請參閱 Version-Independent 名稱和以特定版本的 Windows 為目標。

語法

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

[in] classifyContext

來自 classifyFn1 的 classifyContext 參數。此原則引擎會將此值傳遞至圖說文字驅動程式的 classifyFn。

[in] flags

保留供未來使用。設定為 0。

[out] classifyHandle

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

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

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

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

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