FwpmCalloutAdd0 함수(fwpmk.h)

  • 아티클

FwpmCalloutAdd0 함수는 필터 엔진에 콜아웃을 추가합니다.

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

구문

NTSTATUS FwpmCalloutAdd0(
  [in]            HANDLE               engineHandle,
  [in]            const FWPM_CALLOUT0  *callout,
  [in, optional]  PSECURITY_DESCRIPTOR sd,
  [out, optional] UINT32               *id
);

매개 변수

[in] engineHandle

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

[in] callout

필터 엔진에 설명선 추가에 필요한 데이터를 포함하는 상수 FWPM_CALLOUT0 구조체에 대한 포인터입니다.

[in, optional] sd

필터 엔진에 추가되는 설명자에 대한 보안 설명자를 설명하는 상수 SECURITY_DESCRIPTOR 구조체에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.

[out, optional] id

필터 엔진에서 설명선이 식별되는 런타임 식별자를 수신하는 UINT32 형식 변수에 대한 포인터입니다. 설명선 드라이버가 설명선 드라이버의 설명선 함수를 필터 엔진에 등록할 때 반환되는 것과 동일한 식별자입니다. 설명선 드라이버는 필터 엔진에서 설명선이 제거되면 이 식별자를 FwpmCalloutDeleteById0 함수에 전달합니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.

반환 값

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

반환 코드 설명
STATUS_SUCCESS
 콜아웃이 필터 엔진에 성공적으로 추가되었습니다.
STATUS_FWP_ALREADY_EXISTS
 필터 엔진에 콜아웃을 추가할 수 없습니다. 설명선 매개 변수가 가리키는 FWPM_CALLOUT0 구조체의 calloutKey 멤버에 지정된 GUID와 동일한 식별자가 있는 필터 엔진에 설명선이 이미 있습니다.
기타 상태 코드
 오류가 발생했습니다.

설명

설명선 드라이버는 FwpmCalloutAdd0 함수를 호출하여 필터 엔진에 설명선 추가

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

설명선 드라이버가 필터 엔진에 설명수를 등록하기 전에 필터 작업에 대한 설명선 및 필터를 필터 엔진에 추가할 수 있습니다. 이 경우 작업 유형이 FWP_ACTION_CALLOUT_TERMINATING 또는 FWP_ACTION_CALLOUT_UNKNOWN 있는 필터는 FWP_ACTION_BLOCK 처리되고 작업 유형이 FWP_ACTION_CALLOUT_INSPECTION 있는 필터는 설명선이 필터 엔진에 등록될 때까지 무시됩니다.

요구 사항

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

추가 정보

FWPM_CALLOUT0

FwpmCalloutDeleteById0

FwpmCalloutDeleteByKey0

FwpmEngineOpen0

설명선 유형