FwpmCalloutDeleteByKey0 함수(fwpmk.h)

FwpmCalloutDeleteByKey0 함수는 필터 엔진에서 설명선이 삭제됩니다.

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

구문

NTSTATUS FwpmCalloutDeleteByKey0(
  [in] HANDLE     engineHandle,
  [in] const GUID *key
);

[in] engineHandle

필터 엔진에 대한 열린 세션에 대한 핸들입니다. 콜아웃 드라이버는 FwpmEngineOpen0 함수를 호출하여 필터 엔진에 대한 세션을 엽니다.

[in] key

필터 엔진에서 삭제되는 콜아웃을 고유하게 식별하는 GUID에 대한 포인터입니다. 설명선 드라이버가 FwpmCalloutAdd0 함수를 호출하여 필터 엔진에 설명선이 추가될 때 지정한 것과 동일한 GUID에 대한 포인터여야 합니다.

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

반환 코드	설명
STATUS_SUCCESS	필터 엔진에서 콜아웃이 성공적으로 삭제되었습니다.
STATUS_FWP_IN_USE	필터 엔진에서 하나 이상의 필터는 필터 작업에 대한 설명선 을 지정합니다.
STATUS_FWP_CALLOUT_NOT_FOUND	필터 엔진에는 키 매개 변수에 지정된 GUID와 일치하는 콜아웃이 없습니다.
기타 상태 코드	오류가 발생했습니다.

콜아웃 드라이버는 FwpmCalloutDeleteByKey0 함수를 호출하여 삭제할 콜아웃을 식별하기 위해 GUID 키를 사용하여 필터 엔진에서 콜아웃을 삭제합니다.

설명선 드라이버는 일반적으로 필터 엔진에서 설명선이 삭제되지 않습니다. 대부분의 경우 사용자 모드 Windows 필터링 플랫폼 관리 애플리케이션에서 처리됩니다.

필터 엔진에 필터 작업에 대한 설명선이 지정되는 필터가 없는 경우에만 필터 엔진에서 설명선이 삭제될 수 있습니다.