다음을 통해 공유


IkeextSaEnum2 함수(fwpmu.h)

IkeextSaEnum2 함수는 IKE/AuthIP SA(보안 연결) 열거자에서 결과의 다음 페이지를 반환합니다.

참고IkeextSaEnum2 는 Windows 8에서 사용되는 IkeextSaEnum의 특정 구현입니다. 자세한 내용은 WFP Version-Independent 이름 및 특정 버전의 Windows 대상 지정 을 참조하세요. Windows 7의 경우 IkeextSaEnum1 을 사용할 수 있습니다. Windows Vista의 경우 IkeextSaEnum0 을 사용할 수 있습니다.
 

구문

DWORD IkeextSaEnum2(
  [in]  HANDLE             engineHandle,
  [in]  HANDLE             enumHandle,
  [in]  UINT32             numEntriesRequested,
  [out] IKEEXT_SA_DETAILS2 ***entries,
  [out] UINT32             *numEntriesReturned
);

매개 변수

[in] engineHandle

형식: HANDLE

필터 엔진에 대한 열린 세션에 대한 핸들입니다. FwpmEngineOpen0을 호출하여 필터 엔진에 대한 세션을 엽니다.

[in] enumHandle

형식: HANDLE

IKE/AuthIP SA 열거형에 대한 핸들입니다. IkeextSaCreateEnumHandle0을 호출하여 열거형 핸들을 가져옵니다.

[in] numEntriesRequested

형식: UINT32

요청된 열거형 항목 수입니다.

[out] entries

형식: IKEEXT_SA_DETAILS2***

열거형 항목의 주소입니다.

[out] numEntriesReturned

형식: UINT32*

반환된 열거형 항목의 수입니다.

반환 값

형식:DWORD

반환 코드/값 설명
ERROR_SUCCESS
0
SA가 성공적으로 열거되었습니다.
FWP_E_* 오류 코드
0x80320001— 0x80320039
WFP(Windows 필터링 플랫폼) 관련 오류입니다. 자세한 내용은 WFP 오류 코드를 참조하세요 .
RPC_* 오류 코드
0x80010001— 0x80010122
원격 또는 로컬 방화벽 엔진과 통신하지 못했습니다.

설명

numEntriesReturnednumEntriesRequested보다 작으면 열거형이 소진됩니다.

반환된 항목 배열(개별 항목 자체는 아님)은 FwpmFreeMemory0을 호출하여 해제해야 합니다.

동일한 열거형 핸들을 사용하는 후속 호출은 마지막 출력 버퍼에 있는 항목 다음에 다음 항목 집합을 반환합니다.

IkeextSaEnum2는 열거형 핸들을 만들 때 가져온 SAS의 스냅샷 작동합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 fwpmu.h
라이브러리 Fwpuclnt.lib
DLL Fwpuclnt.dll

추가 정보

IKEEXT_SA_DETAILS2

IkeextSaCreateEnumHandle0