建立可與其他應用程式層強制執行 (ALE) 端點函式搭配使用的控制碼,以列舉端點資料。
備註
FwpsAleEndpointCreateEnumHandle0 是 FwpsAleEndpointCreateEnumHandle 的特定版本。 如需詳細資訊,請參閱 WFP 版本無關的名稱和以特定版本的 Windows 為目標。
語法
DWORD FwpsAleEndpointCreateEnumHandle0(
HANDLE engineHandle,
const FWPS_ALE_ENDPOINT_ENUM_TEMPLATE0 *enumTemplate,
HANDLE *enumHandle
);
參數
engineHandle
與篩選引擎開啟會話的句柄。 當呼叫 FwpmEngineOpen0 開啟會話時,會取得此控制碼。
enumTemplate
指向 FWPS_ALE_ENDPOINT_ENUM_TEMPLATE0 結構的指標,其中包含用於縮小端點列舉結果的參數。
enumHandle
新建立的列舉控制碼。
返回值
FwpsAleEndpointCreateEnumHandle0 函式會傳回下列其中一個 NTSTATUS 程式代碼。
| 回傳碼 | Description |
|---|---|
| STATUS_SUCCESS | 該功能成功了。 |
| 其他狀態代碼 | 發生錯誤。 |
備註
使用呼叫 FwpsAleEndpointCreateEnumHandle0 所取得的控制碼之後,圖說文字驅動程式必須呼叫 FwpsAleEndpointDestroyEnumHandle0 來釋放與控制碼相關聯的系統資源。
需求
| Requirement | 價值觀 |
|---|---|
| Header | fwpsu.h |
| Library | fwpuclnt.lib |