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