ISchemaProvider::LookupAuthoredNamedEntity 메서드(structuredquery.h)

토큰화된 문자열에서 지정된 형식의 명명된 엔터티를 찾아 엔터티 값과 엔터티 값이 차지하는 토큰 수를 반환합니다.

구문

HRESULT LookupAuthoredNamedEntity(
  [in]  IEntity          *pEntity,
  [in]  LPCWSTR          pszInputString,
  [in]  ITokenCollection *pTokenCollection,
  [in]  ULONG            cTokensBegin,
  [out] ULONG            *pcTokensLength,
  [out] LPWSTR           *ppszValue
);

매개 변수

[in] pEntity

형식: IEntity*

찾을 명명된 엔터티의 형식을 식별하는 IEntity 개체에 대한 포인터입니다.

[in] pszInputString

형식: LPCWSTR

명명된 엔터티 키워드를 검색할 입력 문자열입니다.

[in] pTokenCollection

형식: ITokenCollection*

pszInputString 매개 변수에서 문자열의 토큰화에 대한 포인터입니다.

[in] cTokensBegin

형식: ULONG

검색을 시작할 pTokenCollection 에 있는 토큰의 0부터 시작하는 위치입니다.

[out] pcTokensLength

형식: ULONG*

발견된 명명된 엔터티 키워드(keyword) 적용되는 토큰 수에 대한 포인터를 받습니다.

[out] ppszValue

형식: LPWSTR*

발견된 명명된 엔터티의 값에 대한 포인터를 유니코드 문자열로 받습니다. 호출자는 CoTaskMemFree를 호출하여 문자열을 해제해야 합니다. iNamedEntity 개체는 pEntity의 GetNamedEntity 메서드를 호출하고 이 매개 변수에서 받은 문자열을 전달하여 가져올 수 있습니다.

반환 값

형식: HRESULT

cTokensBegin 위치에서 시작하는 토큰 시퀀스가 지정된(엔터티) 형식의 명명된 엔터티를 나타내는 경우 S_OK 반환합니다. 이러한 토큰 시퀀스가 없으면 는 S_FALSE 반환합니다.

설명

메서드는 IConditionGenerator 개체에서 인식되는 명명된 엔터티가 아니라 스키마에서 키워드로 작성된 명명된 엔터티만 찾습니다.

요구 사항