FwpmCalloutAdd0 함수(fwpmk.h)

  • 아티클

FwpmCalloutAdd0 함수는 필터 엔진에 설명선이 추가됩니다.

통사론

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와 동일한 식별자가 있는 필터 엔진에 설명선이 이미 있습니다.
다른 NTSTATUS 코드 오류가 발생했습니다.

발언

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

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

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

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

요구 사항

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

참고 항목