다음을 통해 공유

IIterableConcept::GetDefaultIndexDimensionality 메서드(dbgmodel.h)

  • 아티클

GetDefaultIndexDimensionality 메서드는 기본 인덱스에 대한 차원 수를 반환합니다. 개체를 인덱싱할 수 없는 경우 이 메서드는 0을 반환하고 성공(S_OK)해야 합니다. 이 메서드에서 0이 아닌 값을 반환하는 모든 개체는 다음과 같은 프로토콜 계약에 대한 지원을 선언합니다.

  • 개체는 IIndexableConcept 지원을 통해 인덱싱 가능한 개념을 지원합니다.
  • 반복 가능한 개념의 GetIterator 메서드에서 반환된 IModelIterator 의 GetNext 메서드는 생성된 각 요소에 대해 고유한 기본 인덱스를 반환합니다. 이러한 인덱스에는 여기에 표시된 차원 수가 있습니다.
  • IModelIterator의 GetNext 메서드에서 반환된 인덱스를 인덱싱 가능한 개념(IIndexableConcept)의 GetAt 메서드로 전달하면 GetNext에서 생성한 것과 동일한 개체가 참조됩니다. 동일한 값이 반환됩니다.

구문

HRESULT GetDefaultIndexDimensionality(
  IModelObject *contextObject,
  ULONG64      *dimensionality
);

매개 변수

contextObject

쿼리할 instance(이 포인터)입니다.

dimensionality

기본 인덱서의 차원 수가 여기에 반환됩니다. 반환 값이 0이면 개체를 인덱싱할 수 없음을 나타냅니다.

반환 값

이 메서드는 성공 또는 실패를 나타내는 HRESULT를 반환합니다.

설명

구현 예:

IFACEMETHOD(GetDefaultIndexDimensionality)(_In_ IModelObject * /*pContextObject*/,
                                           _Out_ ULONG64 *pDimensionality)
{
    // If the object is not indexable, pDimensionality should be 0 and the 
    // method should return S_OK.  Here, the object is indexable in one dimension.
    // Providing this information requires that our iterator return these 
    // 1D indexes and that we have an indexer which accepts them.
    *pDimensionality = 1;
    return S_OK;
}

요구 사항

요구 사항 값
헤더 dbgmodel.h

추가 정보

IIterableConcept 인터페이스