共用方式為

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 程式代碼。

傳回碼 描述
STATUS_SUCCESS
 函式成功。
其他狀態代碼
 發生錯誤。

言論

若要列舉 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

另請參閱

FwpsAleEndpointCreateEnumHandle0 FwpsAleEndpointDestroyEnumHandle0

FwpsAleEndpointGetById0

FwpsAleEndpointGetSecurityInfo0 FwpsAleEndpointSetSecurityInfo0