Compartir a través de

Método IIterableConcept::GetDefaultIndexDimensionality (dbgmodel.h)

  • Artículo

El método GetDefaultIndexDimensionality devuelve el número de dimensiones al índice predeterminado. Si un objeto no es indizable, este método debe devolver 0 y correcto (S_OK). Cualquier objeto que devuelva un valor distinto de cero de este método declara la compatibilidad con un contrato de protocolo que indica:

  • El objeto admite el concepto indizable mediante la compatibilidad de IIndexableConcept.
  • El método GetNext del IModelIterator devuelto desde el método GetIterator del concepto iterable devolverá un índice predeterminado único para cada elemento generado. Este índice tendrá el número de dimensiones como se indica aquí.
  • Pasar los índices devueltos desde el método GetNext del IModelIterator al método GetAt en el concepto indexable (IIndexableConcept) hará referencia al mismo objeto generado por GetNext. Se devuelve el mismo valor.

Sintaxis

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

Parámetros

contextObject

Instancia (este puntero) que se consulta.

dimensionality

Aquí se devuelve el número de dimensiones del indexador predeterminado. Un valor devuelto de cero indica que el objeto no es indizable.

Valor devuelto

Este método devuelve HRESULT, que indica que se ha realizado correctamente o no.

Comentarios

Implementación de ejemplo:

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;
}

Requisitos

Requisito Valor
Header dbgmodel.h

Consulte también

Interfaz IIterableConcept