FwpsCalloutUnregisterByKey0 함수(fwpsk.h)
FwpsCalloutUnregisterByKey0 함수는 필터 엔진에서 설명선의 등록을 취소합니다.
구문
NTSTATUS FwpsCalloutUnregisterByKey0(
[in] const GUID *calloutKey
);
매개 변수
[in] calloutKey
필터 엔진에서 등록 취소되는 콜아웃을 고유하게 식별하는 GUID에 대한 포인터입니다. 이 포인터는 설명선 드라이버가 FwpsCalloutRegister0 또는 FwpsCalloutRegister1 함수를 호출하여 설명선이 필터 엔진에 등록될 때 지정한 것과 동일한 GUID에 대한 포인터여야 합니다.
반환 값
FwpsCalloutUnregisterByKey0 함수는 다음 NTSTATUS 코드 중 하나를 반환합니다.
반환 코드 | 설명 |
---|---|
|
필터 엔진에서 콜아웃이 성공적으로 등록 취소되었습니다. |
|
데이터 흐름과 연결된 뛰어난 컨텍스트가 있는 설명선에서 처리되는 하나 이상의 데이터 흐름이 있습니다. 설명선 드라이버는 연결된 컨텍스트를 제거하려면 이러한 각 데이터 흐름에 대해 FwpsFlowRemoveContext0 함수를 호출해야 합니다. 이러한 각 데이터 흐름에서 컨텍스트가 성공적으로 제거된 후 설명선 드라이버는 FwpsCalloutUnregisterByKey0 함수를 다시 호출하여 필터 엔진에서 설명선 등록 취소를 완료해야 합니다. |
|
calloutKey 매개 변수에 지정된 GUID와 일치하는 필터 엔진에 등록된 콜아웃이 없습니다. |
|
콜아웃이 이미 다른 스레드에 등록되거나 등록 취소되는 중입니다. |
|
오류가 발생했습니다. |
설명
설명선 드라이버는 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 |