FwpsAleEndpointEnum0 関数 (fwpsk.h)

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

構文

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 コードのいずれかを返します。

解説

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

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

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

要件

こちらもご覧ください

FwpsAleEndpointGetById0