FwpsAcquireClassifyHandle0 함수(fwpsk.h)

FwpsAcquireClassifyHandle0 함수는 쓰기 가능한 계층 데이터에 대한 비동기 분류 작업 및 요청을 식별하는 데 사용되는 분류 핸들을 생성합니다.

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

구문

NTSTATUS FwpsAcquireClassifyHandle0(
  [in]  void   *classifyContext,
  [in]  UINT32 flags,
  [out] UINT64 *classifyHandle
);

[in] classifyContext

classifyFn1의 classifyContext 매개 변수입니다. WFP 엔진은 이 값을 설명선 드라이버의 classifyFn에 전달합니다.

[in] flags

다음에 사용하도록 예약됩니다. 0으로 설정합니다.

[out] classifyHandle

분류 핸들을 수신하는 변수에 대한 포인터입니다. 이 핸들은 설명에 설명된 대로 후속 함수 호출에 필요합니다.

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

반환 코드	설명
STATUS_SUCCESS	분류 요청에 대한 핸들이 성공적으로 반환되었습니다. classifyHandle 매개 변수가 가리키는 변수는 분류 요청에 대한 핸들을 포함합니다.
기타 상태 코드	오류가 발생했습니다.

FwpsAcquireClassifyHandle0 은 비동기 분류 및 데이터 수정을 위한 지원 함수입니다. 이 함수에서 반환된 핸들은 다음 함수에 대한 매개 변수로 필요합니다.

이 함수를 호출할 때마다 설명선 드라이버는 FwpsReleaseClassifyHandle0 을 호출하여 핸들과 연결된 시스템 리소스를 해제해야 합니다.