FwpsAleEndpointEnum0 함수(fwpsk.h)

  • 아티클

FwpsAleEndpointEnum0 함수는 ALE(애플리케이션 계층 적용) 엔드포인트를 열거합니다.

참고FwpsAleEndpointEnum0 은 특정 버전의 FwpsAleEndpointEnum입니다. 자세한 내용은 WFP 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 을 호출하여 핸들의 열거형 매개 변수와 일치하는 엔드포인트에 대한 정보를 가져올 수 있습니다.

엔드포인트 속성 검사가 완료되면 설명선 드라이버는 FwpsAleEndpointDestroyEnumHandle0 을 호출하여 열거형 핸들과 연결된 시스템 리소스를 해제해야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 7부터 사용할 수 있습니다.
대상 플랫폼 유니버설
헤더 fwpsk.h(Fwpsk.h 포함)
라이브러리 Fwpkclnt.lib
IRQL PASSIVE_LEVEL

추가 정보

FwpsAleEndpointCreateEnumHandle0 FwpsAleEndpointDestroyEnumHandle0

FwpsAleEndpointGetById0

FwpsAleEndpointGetSecurityInfo0 FwpsAleEndpointSetSecurityInfo0