Método IIterableConcept::GetDefaultIndexDimensionality (dbgmodel.h)
El método GetDefaultIndexDimensionality devuelve el número de dimensiones al índice predeterminado. Si un objeto no es indexable, 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 indexable a través de 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 GetNext. Se devuelve el mismo valor.
Sintaxis
HRESULT GetDefaultIndexDimensionality(
IModelObject *contextObject,
ULONG64 *dimensionality
);
Parámetros
contextObject
Instancia de (este puntero) consultada.
dimensionality
Aquí se devuelve el número de dimensiones del indexador predeterminado. Un valor devuelto de cero indica que el objeto no se puede indexar.
Valor devuelto
Este método devuelve HRESULT, que indica que se ha realizado correctamente o no.
Observaciones
Implementación de ejemplo de :
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 |
|---|---|
| encabezado de | dbgmodel.h |