FwpsAleEndpointEnum0 関数 (fwpsk.h)

  • [アーティクル]

FwpsAleEndpointEnum0 関数は、アプリケーション層強制 (ALE) エンドポイントを列挙します。

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

構文

NTSTATUS FwpsAleEndpointEnum0(
  [in]  HANDLE                        engineHandle,
  [in]  HANDLE                        enumHandle,
  [in]  UINT32                        numEntriesRequested,
  [out] FWPS_ALE_ENDPOINT_PROPERTIES0 ***entries,
  [out] UINT32                        *numEntriesReturned
);

パラメーター

[in] engineHandle

フィルター エンジンを使用した開いているセッションのハンドル。 このハンドルは、 FwpmEngineOpen0 を呼び出してセッションを開いたときに取得されます。

[in] enumHandle

FwpsAleEndpointDestroyEnumHandle0 の以前の呼び出しによって作成された列挙ハンドル。

[in] numEntriesRequested

返されるエンドポイント プロパティ エントリの最大数。 列挙されたエントリの実際の数は numEntriesReturned で返されます。 実際の数は、要求された数よりも少ないエンドポイントが存在する場合にのみ、要求された数より小さくなります。

[out] entries

構造体ポインターの配列へのポインター FWPS_ALE_ENDPOINT_PROPERTIES0 。 各構造体には、1 つのエンドポイントのプロパティが含まれています。 配列には、 numEntriesReturned で返される値と同じ数の要素が含まれます。

[out] numEntriesReturned

返された場合、 エントリが指すエンドポイント プロパティ構造体の配列内の要素の数。

戻り値

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

リターン コード 説明
STATUS_SUCCESS
 関数が正常に実行されました。
その他の状態コード
 エラーが発生しました。

解説

ALE エンドポイントを列挙するには、最初に FwpsAleEndpointCreateEnumHandle0 を呼び出して列挙ハンドルを取得する必要があります。 返されるハンドルは、FwpsAleEndpointCreateEnumHandle0 の省略可能な enumTemplate パラメーターで指定されたすべてのパラメーターに関連付けられます。

ハンドルを取得した後、引き出し線ドライバーは FwpsAleEndpointEnum0 を呼び出して、ハンドルの列挙パラメーターに一致するエンドポイントに関する情報を取得できます。

エンドポイント のプロパティの確認が完了したら、引き出し線ドライバーは FwpsAleEndpointDestroyEnumHandle0 を呼び出して、列挙ハンドルに関連付けられているシステム リソースを解放する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 7 以降で使用できます。
対象プラットフォーム ユニバーサル
Header fwpsk.h (Fwpsk.h を含む)
Library Fwpkclnt.lib
IRQL PASSIVE_LEVEL

こちらもご覧ください

FwpsAleEndpointCreateEnumHandle0 FwpsAleEndpointDestroyEnumHandle0

FwpsAleEndpointGetById0

FwpsAleEndpointGetSecurityInfo0 FwpsAleEndpointSetSecurityInfo0