FwpsAcquireClassifyHandle0 関数 (fwpsk.h)

FwpsAcquireClassifyHandle0 関数は、非同期の分類操作と書き込み可能なレイヤーデータの要求を識別するために使用される分類ハンドルを生成します。

メモFwpsAcquireClassifyHandle0 は、 FwpsAcquireClassifyHandle の特定のバージョンです。詳細については、「 WFP Version-Independent 名と特定のバージョンの Windows を対象とする」を参照してください。

構文

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

[in] classifyContext

classifyFn1 の classifyContext パラメーター。 WFP エンジンは、この値を引き出しドライバーの classifyFn に渡します。

[in] flags

将来利用するために予約されています。 0 に設定されます。

[out] classifyHandle

分類ハンドルを受け取る変数へのポインター。このハンドルは、「解説」で説明されているように、後続の関数呼び出しで必要になります。

FwpsAcquireClassifyHandle0 関数は、次の NTSTATUS コードのいずれかを返します。

リターンコード	説明
STATUS_SUCCESS	分類要求へのハンドルが正常に返されました。 classifyHandle パラメーターが指す変数には、分類要求のハンドルが含まれています。
その他の状態コード	エラーが発生しました。

FwpsAcquireClassifyHandle0 は、非同期分類とデータ変更のサポート関数です。この関数によって返されるハンドルは、次の関数のパラメーターとして必要です。

この関数を呼び出すたびに、コールアウトドライバーは FwpsReleaseClassifyHandle0 を呼び出して、ハンドルに関連付けられているシステムリソースを解放する必要があります。