FWPM_CALLOUT0 구조체(fwpmtypes.h)

FWPM_CALLOUT0 구조체는 설명선과 연결된 상태를 저장합니다.

구문

typedef struct FWPM_CALLOUT0_ {
  GUID               calloutKey;
  FWPM_DISPLAY_DATA0 displayData;
  UINT32             flags;
  GUID               *providerKey;
  FWP_BYTE_BLOB      providerData;
  GUID               applicableLayer;
  UINT32             calloutId;
} FWPM_CALLOUT0;

멤버

calloutKey

세션을 고유하게 식별합니다.

FwpmCalloutAdd0 호출에서 GUID가 0으로 초기화되면 BFE(기본 필터링 엔진)가 생성됩니다.

displayData

설명선과 연결된 사람이 읽을 수 있는 주석을 포함하는 FWPM_DISPLAY_DATA0 구조체입니다. FWPM_DISPLAY_DATA0 구조체의 이름 멤버가 필요합니다.

flags

값	의미
FWPM_CALLOUT_FLAG_PERSISTENT	콜아웃은 다시 부팅할 때 지속됩니다. 결과적으로 부팅 시간 및 기타 영구 필터에서 참조할 수 있습니다.
FWPM_CALLOUT_FLAG_USES_PROVIDER_CONTEXT	설명선은 설명선 호출 필터에 저장된 공급자 컨텍스트에 액세스해야 합니다. 이 플래그가 설정되면 공급자 컨텍스트가 [FWPM_FILTER0](/windows/desktop/api/fwpmtypes/ns-fwpmtypes-fwpm_filter0) 구조체에서 FWPS_FILTER0 구조체로 복사됩니다. FWPS_FILTER0 구조체는 WDK에 설명되어 있습니다.
FWPM_CALLOUT_FLAG_REGISTERED	현재 커널에 콜아웃이 등록되어 있습니다. 새 설명선 추가 시 이 플래그를 설정해서는 안 됩니다. 기존 설명선의 상태를 쿼리하는 데만 사용됩니다.

providerKey

콜아웃과 연결된 공급자를 고유하게 식별합니다. 멤버가 NULL이 아닌 경우 지정된 공급자와 연결된 개체만 반환됩니다.

providerData

공급자가 개체와 함께 추가 컨텍스트 정보를 저장할 수 있도록 하는 선택적 공급자별 데이터를 포함하는 FWP_BYTE_BLOB 구조체입니다.

applicableLayer

콜아웃을 사용할 수 있는 계층을 지정합니다. 이 계층의 필터만 설명선 호출할 수 있습니다. 자세한 내용은 계층 식별자 필터링을 참조하세요.

calloutId

콜아웃을 식별하는 LUID입니다. 설명선 호출 필터의 FWPS_ACTION0 구조에 저장된 calloutId입니다. FWPS_ACTION0 구조체는 WDK에 설명되어 있습니다.

설명

이 구조체의 처음 6개 멤버는 개체를 추가할 때 제공되는 데이터를 포함합니다.

마지막 멤버인 calloutId는 개체를 가져오고 열거할 때 반환되는 추가 정보를 제공합니다.

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
머리글	fwpmtypes.h

추가 정보

Windows 필터링 플랫폼 API 구조