INamedEntityCollector::Add 메서드(structuredquery.h)

구문 분석 중인 입력 문자열의 토큰화된 범위에서 식별된 대로 이 INamedEntityCollector 컬렉션에 명명된 단일 엔터티를 추가합니다.

구문

HRESULT Add(
  [in] ULONG                  beginSpan,
  [in] ULONG                  endSpan,
  [in] ULONG                  beginActual,
  [in] ULONG                  endActual,
  [in] IEntity                *pType,
  [in] LPCWSTR                pszValue,
  [in] NAMED_ENTITY_CERTAINTY certainty
);

매개 변수

[in] beginSpan

형식: ULONG

선행 따옴표를 포함하여 전체 토큰 범위의 시작입니다.

[in] endSpan

형식: ULONG

후행 따옴표를 포함한 전체 토큰 범위의 끝입니다.

[in] beginActual

형식: ULONG

잠재적인 명명된 엔터티를 식별하는 토큰 범위 부분의 시작입니다.

[in] endActual

형식: ULONG

잠재적인 명명된 엔터티를 식별하는 토큰 범위 부분의 끝입니다.

[in] pType

형식: IEntity*

명명된 엔터티의 의미 체계 형식입니다.

[in] pszValue

형식: LPCWSTR

문자열로 엔터티의 이름입니다.

[in] certainty

형식: NAMED_ENTITY_CERTAINTY

다음 값 중 하나입니다.

값	정보 산업
NEC_LOW	이 명명된 엔터티일 수 있지만 추가 증거가 권장됩니다.
NEC_MEDIUM	이 명명된 엔터티일 수 있습니다. 사용해도 괜찮습니다.
NEC_HIGH	거의 확실하게 명명된 엔터티입니다. 다른 가능성을 무시해도 됩니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

쿼리 파서가 입력 문자열을 조건 노드로 구문 분석하면 파서는 IConditionGenerator 개체를 호출합니다. 이 개체는 INamedEntityCollector::Add 를 호출하여 입력 문자열에서 가능한 명명된 엔터티를 수집합니다. IConditionGenerator 개체는 입력 문자열에서 인식하는 각 잠재적인 명명된 엔터티에 대해 이 메서드를 호출해야 합니다. 각 엔터티에 대해 조건 생성기는 다음 정보를 제공해야 합니다.

• 포함하는 입력 문자열의 일부
• 명명된 엔터티의 의미 체계 형식
• 명명된 엔터티 값의 문자열 표현
• 입력이 실제로 명명된 엔터티라는 확실한 수준입니다.

명명된 엔터티가 입력 문자열의 해석에 사용된 경우 조건 생성기의 GenerateForLeaf 메서드가 인수 중 하나로 값 문자열과 함께 호출됩니다.

beginSpanbeginActualendActual = <endSpan = 의 네 가지 첫 번째 인수 간에 다음 관계를 유지 관리해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	WINDOWS XP SP2, Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	WINDOWS Server 2003 SP1 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	structuredquery.h
재배포 가능 파일	WDS(Windows 데스크톱 검색) 3.0