IConditionFactory2::CreateLeaf 메서드(structuredquery.h)

아티클
08/08/2024

모든 값에 대한 리프 조건 노드를 만듭니다. 반환된 개체는 ICondition 및 ICondition2를 지원합니다.

구문

HRESULT CreateLeaf(
  [in]           REFPROPERTYKEY             propkey,
  [in]           CONDITION_OPERATION        cop,
  [in]           REFPROPVARIANT             propvar,
  [in, optional] LPCWSTR                    pszSemanticType,
  [in, optional] LPCWSTR                    pszLocaleName,
  [in, optional] IRichChunk                 *pPropertyNameTerm,
  [in, optional] IRichChunk                 *pOperationTerm,
  [in, optional] IRichChunk                 *pValueTerm,
  [in]           CONDITION_CREATION_OPTIONS cco,
  [in]           REFIID                     riid,
  [out]          void                       **ppv
);

매개 변수

[in] propkey

형식: REFPROPERTYKEY

REFPROPERTYKEY로 리프 조건의 속성 이름입니다. 리프에 특정 속성이 없으면 PKEY_Null 사용합니다.

[in] cop

형식: CONDITION_OPERATION

CONDITION_OPERATION 열거형입니다. 리프에 특정 작업이 없는 경우 COP_IMPLICIT 사용합니다.

[in] propvar

형식: REFPROPERTYKEY

REFPROPERTYKEY인 리프 조건의 속성 값입니다.

[in, optional] pszSemanticType

형식: LPCWSTR

값의 의미 체계 형식 이름 또는 일반 문자열의 경우 NULL 입니다. 새로 만든 리프가 해결되지 않은 명명된 엔터티인 경우 pszSemanticType 은 의미 체계 형식의 이름이고, 그렇지 않으면 NULL이어야 합니다.

[in, optional] pszLocaleName

형식: LPCWSTR

비교할 로캘의 이름 또는 지정되지 않은 로캘의 경우 NULL 입니다. propvar에 문자열 값이 없으면 pszLocaleName을 LOCALE_NAME_USER_DEFAULT 합니다. 그렇지 않으면 pszLocaleName은 문자열 언어를 반영해야 합니다. 또는 pszLocaleName 을 LOCALE_NAME_INVARIANT 수 있습니다.

[in, optional] pPropertyNameTerm

형식: IRichChunk*

속성을 나타내는 입력 문자열의 범위를 식별하는 IRichChunk 에 대한 포인터입니다. NULL일 수 있습니다.

[in, optional] pOperationTerm

형식: IRichChunk*

작업을 나타내는 입력 문자열의 범위를 식별하는 IRichChunk 에 대한 포인터입니다. NULL일 수 있습니다.

[in, optional] pValueTerm

형식: IRichChunk*

값을 나타내는 입력 문자열의 범위를 식별하는 IRichChunk 에 대한 포인터입니다. NULL일 수 있습니다.

[in] cco

형식: CONDITION_CREATION_OPTIONS

리프 조건의 조건 생성 작업은 CONDITION_CREATION_OPTIONS 열거형입니다.

[in] riid

형식: REFIID

열거형 인터페이스의 원하는 IID: IEnumUnknown, IEnumVARIANT 또는 (부정 조건의 경우) IID_ICondition.

[out] ppv

형식: void**

0개 이상의 ICondition 및 ICondition2 개체 에 대한 포인터를 받습니다.

반환 값

이 메서드는 값을 반환하지 않습니다.

설명

기본 옵션의 경우 CONDITION_CREATION_DEFAULT 플래그를 사용합니다.

문자열을 구문 분석하여 리프 조건을 가져온 경우 pPropertyNameTerm, pOperationTerm 및 pValueTerm 매개 변수 중 하나 이상이 IRichChunk 인터페이스( ICondition::GetInputTerms 메서드를 통해 가져온)로 표시될 수 있습니다. 그렇지 않으면 세 매개 변수가 모두 NULL일 수 있습니다.

리프 노드 용어(속성, 값 및 작업)에 대한 자세한 내용은 ICondition::GetInputTerms를 참조하세요.

가상 속성에는 키가 "MapsToRelation"이고 값이 속성 이름(속성의 한 확장)인 하나 이상의 메타데이터 항목이 있습니다. 메타데이터에 대한 자세한 내용은 MetaData를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	structuredquery.h