IPsecSaContextCreate1 함수(fwpmu.h)
IPsecSaContextCreate1 함수는 IPsec SA(보안 연결) 컨텍스트를 만듭니다.
구문
DWORD IPsecSaContextCreate1(
[in] HANDLE engineHandle,
[in] const IPSEC_TRAFFIC1 *outboundTraffic,
[in, optional] const IPSEC_VIRTUAL_IF_TUNNEL_INFO0 *virtualIfTunnelInfo,
[out, optional] UINT64 *inboundFilterId,
[out] UINT64 *id
);
매개 변수
[in] engineHandle
형식: HANDLE
필터 엔진에 대한 열린 세션에 대한 핸들입니다. FwpmEngineOpen0을 호출하여 필터 엔진에 대한 세션을 엽니다.
[in] outboundTraffic
형식: IPSEC_TRAFFIC1*
SA의 아웃바운드 트래픽입니다.
[in, optional] virtualIfTunnelInfo
형식: IPSEC_VIRTUAL_IF_TUNNEL_INFO0*
가상 인터페이스 터널링과 관련된 세부 정보입니다.
[out, optional] inboundFilterId
형식: UINT64*
호출자가 지정한 outboundTraffic 매개 변수에 해당하는 캐시된 인바운드 필터의 선택적 필터 식별자입니다. BFE(기본 필터링 엔진)는 인바운드 필터 식별자를 캐시하고 캐시된 값을 반환할 수 있습니다(사용 가능한 경우). 호출자는 BFE에 캐시된 값이 없는 경우 이 경우 이 매개 변수를 0으로 설정해야 합니다.
[out] id
형식: UINT64*
IPsec SA 컨텍스트의 식별자입니다.
반환 값
형식:DWORD
| 반환 코드/값 | 설명 |
|---|---|
|
IPsec SA 컨텍스트가 성공적으로 만들어졌습니다. |
|
WFP(Windows 필터링 플랫폼) 관련 오류입니다. 자세한 내용은 WFP 오류 코드를 참조하세요. |
|
원격 또는 로컬 방화벽 엔진과 통신하지 못했습니다. |
설명
이 함수는 트랜잭션 내에서 호출할 수 없습니다. FWP_E_TXN_IN_PROGRESS 실패합니다. 트랜잭션에 대한 자세한 내용은 개체 관리를 참조하세요.
이 함수는 동적 세션 내에서 호출할 수 없습니다. FWP_E_DYNAMIC_SESSION_IN_PROGRESS 호출이 실패합니다. 동적 세션에 대한 자세한 내용은 개체 관리를 참조하세요.
호출자는 IPsec 보안 연결 데이터베이스에 FWPM_ACTRL_ADD 액세스해야 합니다. 자세한 내용은 Access Control 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | fwpmu.h |
| 라이브러리 | Fwpuclnt.lib |
| DLL | Fwpuclnt.dll |