FwpmConnectionUnsubscribe0 함수(fwpmu.h)

FwpmConnectionUnsubscribe0 함수는 연결 개체 변경 이벤트 구독을 취소하고 알림 수신을 중지하는 데 사용됩니다.

구문

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

[in] engineHandle

형식: HANDLE

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

[in, out] eventsHandle

형식: HANDLE

구독된 이벤트 알림의 핸들입니다. FwpmConnectionSubscribe0 호출에서 반환된 핸들입니다.

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

형식:DWORD

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

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

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

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