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。 各構造体には、単一のエンドポイントのプロパティが含まれています。 配列には、numEntriesReturned で返される値と同じ数要素が含まれます。
[out] numEntriesReturned
返された場合、エントリが指すエンドポイント プロパティ構造体の配列内の要素の数。
戻り値
FwpsAleEndpointEnum0 関数は、次のいずれかの NTSTATUS コードを返します。
| リターン コード | 形容 |
|---|---|
|
関数は成功しました。 |
|
エラーが発生しました。 |
備考
ALE エンドポイントを列挙するには、引き出し線ドライバーは、まず FwpsAleEndpointCreateEnumHandle0 呼び出して列挙ハンドルを取得する必要があります。 返されるハンドルは、fwpsAleEndpointCreateEnumHandle0 の省略可能な enumTemplate パラメーター指定されたすべてのパラメーターに関連付けられます。
ハンドルを取得した後、引き出し線ドライバーは、FwpsAleEndpointEnum0 を呼び出して、ハンドルの列挙パラメーターに一致するエンドポイントに関する情報を取得できます。
返されたFWPS_ALE_ENDPOINT_PROPERTIES0の localV4Address フィールドはホストバイト順であり、localV6Address はネットワークバイト順であることに注意してください。 localV4Address フィールドから IPv4 アドレスを使用するには、localV4Address で htonl() を呼び出してin_addr構造体に格納し、sockaddr が正しく書式設定されていることを確認する必要があります。
エンドポイントのプロパティの調査が完了したら、コールアウト ドライバーは、列挙ハンドルに関連付けられているシステム リソース 解放するために、FwpsAleEndpointDestroyEnumHandle0 を呼び出す必要があります。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 7 以降で使用できます。 |
| ターゲット プラットフォーム の | 万国 |
| ヘッダー | fwpsk.h (Fwpsk.h を含む) |
| ライブラリ | Fwpkclnt.lib |
| IRQL | PASSIVE_LEVEL |