다음을 통해 공유


IPsecSaContextUnsubscribe0 함수(fwpmu.h)

IPsecSaContextUnsubscribe0 함수는 IPsec SA(보안 연결) 변경 구독을 취소하고 변경 알림 수신을 중지하는 데 사용됩니다.

구문

DWORD IPsecSaContextUnsubscribe0(
  [in]      HANDLE engineHandle,
  [in, out] HANDLE eventsHandle
);

매개 변수

[in] engineHandle

형식: HANDLE

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

[in, out] eventsHandle

형식: HANDLE

구독된 SA 변경 알림의 핸들입니다. IPsecSaContextSubscribe0 호출에서 반환된 핸들입니다.

NULL일 수 있습니다. 이 경우 함수는 영향을 주지 않습니다.

반환 값

형식:DWORD

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

설명

콜백이 현재 호출되는 경우 이 함수는 완료될 때까지 반환되지 않습니다. 따라서 이 함수를 호출할 때 교착 상태가 발생하지 않도록 콜백이 획득하려고 시도할 수 있는 잠금을 보유해서는 안 됩니다.

세션을 닫기 전에 구독을 취소할 필요는 없습니다. 구독 세션이 종료되면 모든 구독이 자동으로 취소됩니다.

이 함수는 트랜잭션 내에서 호출할 수 없습니다. FWP_E_TXN_IN_PROGRESS 실패합니다. 트랜잭션에 대한 자세한 내용은 개체 관리를 참조하세요.

요구 사항

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