FwpsCalloutUnregisterById0 함수(fwpsk.h)

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

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

 

구문

NTSTATUS FwpsCalloutUnregisterById0(
  [in] const UINT32 calloutId
);

매개 변수

[in] calloutId

필터 엔진에서 등록 취소되는 콜아웃의 런타임 식별자입니다. 설명선 드라이버가 FwpsCalloutRegister0 또는 FwpsCalloutRegister1 함수를 호출하여 콜아웃을 필터 엔진에 등록할 때 반환된 런타임 식별자여야 합니다.

반환 값

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

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

설명

설명선 드라이버는 FwpsCalloutUnregisterById0 함수를 호출하여 런타임 식별자를 사용하여 등록 취소할 설명선 식별자를 사용하여 필터 엔진에서 설명선의 등록을 취소합니다. 필터 엔진에 필터 작업에 대한 설명선이 지정되는 필터가 있더라도 이 함수는 성공합니다. 이 경우 작업 유형이 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

FwpsCalloutUnregisterByKey0

FwpsFlowRemoveContext0

설명선 유형