ICoreFragment::NextRange
Devuelve el siguiente intervalo que contiene este fragmento de conocimiento y el vector de reloj que define la información sobre los elementos en el intervalo.
HRESULT NextRange(
BYTE* pItemId,
DWORD* pItemIdSize,
IClockVector** piClockVector);
Parámetros
- pItemId
[in, out, unique, size_is(*pItemIdSize)] Devuelve el límite inferior cerrado de identificadores de elemento de este rango. Este valor es también el límite superior abierto de los identificadores de elemento del intervalo anterior cuando este intervalo no es el primero del conjunto de intervalos.
- pItemIdSize
[in, out] Especifica el número de bytes de pItemId. Devuelve el número de bytes necesarios para recuperar el identificador si pItemId es demasiado pequeño, o devuelve el número de bytes escritos.
- piClockVector
[out] Devuelve el vector de reloj que define lo que se conoce sobre los elementos del intervalo.
Valor devuelto
S_OK
S_FALSE si no hay más intervalos a enumerar.
E_POINTER si el identificador de elemento es un identificador de longitud variable y pItemIdSize es NULL.
HRESULT_FROM_WIN32(ERROR_MORE_DATA) si pItemId es demasiado pequeño. En esta situación, el número necesario de bytes se devuelve en pItemIdSize.
SYNC_E_INVALID_OPERATION si el objeto de conocimiento que contiene este objeto hubiera cambiado desde que se creó este objeto.
Notas
El valor que se devuelve en pItemId es el límite inferior cerrado del intervalo de identificadores de elemento asociados al vector de reloj que se devuelve en piClockVector. El valor de pItemId también define el límite superior abierto del intervalo anterior, de forma que el límite superior abierto del intervalo actual se puede obtener llamando de nuevo a NextRange. Si no hay más intervalos a enumerar, el intervalo contendrá todos los elementos con identificadores mayores o iguales a pItemId.