FwpsCalloutUnregisterById0 함수(fwpsk.h)
FwpsCalloutUnregisterById0 함수는 필터 엔진에서 설명선의 등록을 취소합니다.
참고FwpsCalloutUnregisterById0 은 특정 버전의 FwpsCalloutUnregisterById입니다. 자세한 내용은 WFP Version-Independent 이름 및 특정 버전의 Windows 대상 지정 을 참조하세요.
구문
NTSTATUS FwpsCalloutUnregisterById0(
[in] const UINT32 calloutId
);
매개 변수
[in] calloutId
필터 엔진에서 등록 취소되는 콜아웃의 런타임 식별자입니다. 설명선 드라이버가 FwpsCalloutRegister0 또는 FwpsCalloutRegister1 함수를 호출하여 콜아웃을 필터 엔진에 등록할 때 반환된 런타임 식별자여야 합니다.
반환 값
FwpsCalloutUnregisterById0 함수는 다음 NTSTATUS 코드 중 하나를 반환합니다.
반환 코드 | 설명 |
---|---|
|
필터 엔진에서 콜아웃의 등록을 취소했습니다. |
|
데이터 흐름과 연결된 미해결 컨텍스트가 있는 설명선에서 처리되는 데이터 흐름이 하나 이상 있습니다. 설명선 드라이버는 연결된 컨텍스트를 제거하려면 이러한 각 데이터 흐름에 대해 FwpsFlowRemoveContext0 함수를 호출해야 합니다. 이러한 각 데이터 흐름에서 컨텍스트가 성공적으로 제거된 후 설명선 드라이버는 FwpsCalloutUnregisterById0 함수를 다시 호출하여 필터 엔진에서 설명선 등록 취소를 완료해야 합니다. |
|
calloutId 매개 변수에 지정된 런타임 식별자와 일치하는 필터 엔진에 등록된 콜아웃이 없습니다. |
|
콜아웃이 이미 다른 스레드에 등록되거나 등록 취소되는 중입니다. |
|
오류가 발생했습니다. |
설명
설명선 드라이버는 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 |