共用方式為

FwpsAleEndpointEnum0 函式 (fwpsk.h)

  • 發行項

FwpsAleEndpointEnum0 函式會列舉 ALE) 端點 (應用層強制執行。

注意FwpsAleEndpointEnum0 是特定版本的 FwpsAleEndpointEnum。 如需詳細資訊 ，請參閱 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結構指標陣列的指標。 每個結構都包含單一端點的屬性。 數位包含與 numEntriesReturned 中傳回的值一樣多的專案。

[out] numEntriesReturned

傳回時，端點屬性結構陣列中由 專案指向的項目數。

傳回值

FwpsAleEndpointEnum0 函式會傳回下列其中一個 NTSTATUS 代碼。

傳回碼 Description
STATUS_SUCCESS
 此函數已成功。
其他狀態代碼
 發生錯誤。

備註

若要列舉 ALE 端點，圖說文字驅動程式必須先呼叫 FwpsAleEndpointCreateEnumHandle0 來取得列舉句柄。 傳回的句柄會與 FwpsAleEndpointCreateEnumHandle0 的選擇性 enumTemplate 參數中指定的任何參數相關聯。

取得句柄之後，圖說文字驅動程式可以呼叫 FwpsAleEndpointEnum0 ，以取得符合句柄列舉參數的端點相關信息。

完成檢查端點屬性時，圖說文字驅動程式必須呼叫 FwpsAleEndpointDestroyEnumHandle0 以釋放與列舉句柄相關聯的系統資源。

規格需求

需求 值
最低支援的用戶端 從 Windows 7 開始提供。
目標平台 Universal
標頭 fwpsk.h (包含 Fwpsk.h)
程式庫 Fwpkclnt.lib
IRQL PASSIVE_LEVEL

另請參閱

FwpsAleEndpointCreateEnumHandle0 FwpsAleEndpointDestroyEnumHandle0

FwpsAleEndpointGetById0

FwpsAleEndpointGetSecurityInfo0 FwpsAleEndpointSetSecurityInfo0