FwpmIPsecTunnelAdd0 함수(fwpmk.h)
FwpmIPsecTunnelAdd0 함수는 시스템에 새 IPsec(인터넷 프로토콜 보안) 터널 모드 정책을 추가합니다.
통사론
NTSTATUS FwpmIPsecTunnelAdd0(
[in] HANDLE engineHandle,
[in] UINT32 flags,
[in, optional] const FWPM_PROVIDER_CONTEXT0 *mainModePolicy,
[in] const FWPM_PROVIDER_CONTEXT0 *tunnelPolicy,
[in] UINT32 numFilterConditions,
[ in, reads(numFilterConditions)] const FWPM_FILTER_CONDITION0 *filterConditions,
[in, optional] PSECURITY_DESCRIPTOR sd
);
매개 변수
[in] engineHandle
필터 엔진에 대한 열린 세션에 대한 핸들입니다. FwpmEngineOpen0 호출하여 필터 엔진에 대한 세션을 엽니다.
[in] flags
가능한 값:
IPsec 터널 플래그 | 의미 |
---|---|
FWPM_TUNNEL_FLAG_POINT_TO_POINT | 시스템에 지점 및 지점 간의 터널을 추가합니다. |
[in, optional] mainModePolicy
IPsec 터널에 대한 기본 모드 정책입니다.
[in] tunnelPolicy
IPsec 터널에 대한 빠른 모드 정책입니다.
[in] numFilterConditions
filterConditions 매개 변수에 있는 필터 조건 수입니다.
[ in, reads(numFilterConditions)] filterConditions
IPsec에 의해 터널되어야 하는 트래픽을 설명하는 필터 조건의 배열입니다.
[in, optional] sd
IPsec 터널과 연결된 보안 정보입니다.
반환 값
반환 코드/값 | 묘사 |
---|---|
ERROR_SUCCESS 0 |
IPsec 터널 모드 정책이 성공적으로 추가되었습니다. |
FWP_E_INVALID_PARAMETER 0x80320035 |
FWPM_TUNNEL_FLAG_POINT_TO_POINT 설정되지 않았으며 로컬/원격 주소 이외의 조건이 지정되었습니다. |
FWP_E_* 오류 코드 0x80320001 — 0x80320039 |
WFP(Windows 필터링 플랫폼) 관련 오류입니다. 자세한 내용은 WFP 오류 코드 참조하세요. |
RPC_* 오류 코드 0x80010001 — 0x80010122 |
원격 또는 로컬 방화벽 엔진과 통신하지 못했습니다. |
다른 NTSTATUS 코드 |
오류가 발생했습니다. |
발언
이 함수는 읽기 전용 트랜잭션 내에서 호출할 수 없으며 FWP_E_INCOMPATIBLE_TXN함께 실패합니다. 트랜잭션에 대한 자세한 내용은 개체 관리 참조하세요.
FwpmIPsecTunnelAdd0FwpmIPsecTunnelAdd특정 구현입니다. 자세한 내용은 WFP Version-Independent 이름 및 특정 버전의 Windows 대상으로 지정을 참조하세요.
요구 사항
요구 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows Vista부터 사용할 수 있습니다. |
대상 플랫폼 | 보편적 |
헤더 | fwpmk.h |
라이브러리 | fwpkclnt.lib |
IRQL |
<= PASSIVE_LEVEL |