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 ，以取得符合句柄列舉參數的端點相關信息。

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

規格需求

另請參閱

FwpsAleEndpointGetById0