FwpsCalloutUnregisterByKey0 함수(fwpsk.h)

FwpsCalloutUnregisterByKey0 함수는 필터 엔진에서 설명선의 등록을 취소합니다.

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

구문

NTSTATUS FwpsCalloutUnregisterByKey0(
  [in] const GUID *calloutKey
);

매개 변수

[in] calloutKey

필터 엔진에서 등록 취소되는 설명선이 고유하게 식별되는 GUID에 대한 포인터입니다. 이 포인터는 설명선 드라이버가 FwpsCalloutRegister0 또는 FwpsCalloutRegister1 함수를 호출하여 필터 엔진에 설명선 등록 시 지정한 것과 동일한 GUID에 대한 포인터여야 합니다.

반환 값

FwpsCalloutUnregisterByKey0 함수는 다음 NTSTATUS 코드 중 하나를 반환합니다.

반환 코드 설명
STATUS_SUCCESS
필터 엔진에서 설명선 등록이 취소되었습니다.
STATUS_DEVICE_BUSY
데이터 흐름과 연결된 처리 중인 컨텍스트가 있는 설명선에서 처리되는 데이터 흐름이 하나 이상 있습니다. 설명선 드라이버는 연결된 컨텍스트를 제거하려면 이러한 각 데이터 흐름에 대해 FwpsFlowRemoveContext0 함수를 호출해야 합니다. 이러한 각 데이터 흐름에서 컨텍스트가 성공적으로 제거된 후 설명선 드라이버는 FwpsCalloutUnregisterByKey0 함수를 다시 호출하여 필터 엔진에서 설명선 등록 취소를 완료해야 합니다.
STATUS_FWP_CALLOUT_NOT_FOUND
calloutKey 매개 변수에 지정된 GUID와 일치하는 필터 엔진에 등록된 설명선이 없습니다.
STATUS_FWP_IN_USE
설명선이 이미 다른 스레드에서 등록 또는 등록 취소 중입니다.
기타 상태 코드
오류가 발생했습니다.

설명

설명선 드라이버는 FwpsCalloutUnregisterByKey0 함수를 호출하여 GUID 키를 사용하여 등록 취소할 설명선 식별을 사용하여 필터 엔진에서 설명선의 등록을 취소합니다. 필터 엔진에 필터 작업에 대한 설명선이 지정되는 필터가 있더라도 이 함수는 성공합니다. 이 경우 작업 유형이 FWP_ACTION_CALLOUT_TERMINATING 또는 FWP_ACTION_CALLOUT_UNKNOWN 있는 필터는 FWP_ACTION_BLOCK 처리되고 작업 유형 이 FWP_ACTION_CALLOUT_INSPECTION 필터는 필터 엔진에서 설명선이 등록 취소된 후 무시됩니다.

이전에 필터 엔진에 등록된 모든 설명선이 성공적으로 등록 취소될 때까지 설명선 드라이버를 언로드할 수 없습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista부터 사용할 수 있습니다.
대상 플랫폼 유니버설
헤더 fwpsk.h(Fwpsk.h 포함)
라이브러리 Fwpkclnt.lib
IRQL PASSIVE_LEVEL

참고 항목

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsCalloutUnregisterById0

FwpsFlowRemoveContext0

설명선 유형