IPsecSaContextUpdate0 함수(fwpmu.h)

  • 아티클

IPsecSaContextUpdate0 함수는 SA(IPsec 보안 연결) 컨텍스트를 업데이트합니다.

구문

DWORD IPsecSaContextUpdate0(
  [in] HANDLE                  engineHandle,
  [in] UINT64                  flags,
  [in] const IPSEC_SA_CONTEXT1 *newValues
);

매개 변수

[in] engineHandle

형식: HANDLE

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

[in] flags

형식: UINT32

업데이트되는 IPSEC_SA_CONTEXT1 구조체의 특정 필드를 나타내는 플래그입니다.

가능한 값은 다음과 같습니다.

IPsec SA 플래그 의미
IPSEC_SA_DETAILS_UPDATE_TRAFFIC
 [IPSEC_SA_DETAILS1](/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_details1) 구조체를 업데이트.
IPSEC_SA_DETAILS_UPDATE_UDP_ENCAPSULATION
 [IPSEC_SA_DETAILS1](/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_details1) 구조체를 업데이트.
IPSEC_SA_BUNDLE_UPDATE_FLAGS
 [IPSEC_SA_BUNDLE1](/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_bundle1) 구조체를 업데이트.
IPSEC_SA_BUNDLE_UPDATE_NAP_CONTEXT
 [IPSEC_SA_BUNDLE1](/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_bundle1) 구조체를 업데이트.
IPSEC_SA_BUNDLE_UPDATE_KEY_MODULE_STATE
 [IPSEC_SA_BUNDLE1](/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_bundle1) 구조체를 업데이트.
IPSEC_SA_BUNDLE_UPDATE_PEER_V4_PRIVATE_ADDRESS
 [IPSEC_SA_BUNDLE1](/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_bundle1) 구조체를 업데이트.
IPSEC_SA_BUNDLE_UPDATE_MM_SA_ID
 [IPSEC_SA_BUNDLE1](/windows/desktop/api/ipsectypes/ns-ipsectypes-ipsec_sa_bundle1) 구조체를 업데이트.

[in] newValues

형식: IPSEC_SA_CONTEXT1*

인바운드 및 아웃바운드 SA 쌍입니다.

반환 값

형식:DWORD

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

설명

IPsecSaContextUpdate0 은 IPsecSaContextUpdate의 특정 구현입니다. 자세한 내용은 WFP Version-Independent 이름 및 특정 버전의 Windows 대상 지정 을 참조하세요.

요구 사항

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

추가 정보

IPSEC_SA_CONTEXT1