ICoreFragment::NextRange
Gibt den nächsten in diesem Wissensfragment enthaltenen Bereich sowie den Taktvektor zurück, der das Wissen über die Elemente im Bereich definiert.
HRESULT NextRange(
BYTE* pItemId,
DWORD* pItemIdSize,
IClockVector** piClockVector);
Parameter
- pItemId
[in, out, unique, size_is(*pItemIdSize)] Gibt die geschlossene Untergrenze der Element-IDs in diesem Bereich zurück. Dieser Wert ist auch die geöffnete Obergrenze der Element-IDs im vorherigen Bereich, wenn dieser Bereich nicht der erste Bereich im Bereichssatz ist.
- pItemIdSize
[in, out] Gibt die Anzahl der Bytes in pItemId an. Gibt entweder die Anzahl der zum Abrufen der ID erforderlichen Bytes zurück, wenn pItemId zu klein ist, oder die Anzahl der geschriebenen Bytes.
- piClockVector
[out] Gibt den Taktvektor zurück, der das Wissen über die Elemente im Bereich definiert.
Rückgabewert
S_OK
S_FALSE, wenn keine weiteren Bereiche aufzulisten sind.
E_POINTER, wenn die Element-ID eine ID mit variabler Länge ist, und pItemIdSize NULL ist.
HRESULT_FROM_WIN32(ERROR_MORE_DATA), wenn pItemId zu klein ist. In dieser Situation wird in pItemIdSize die erforderliche Anzahl der Bytes zurückgegeben.
SYNC_E_INVALID_OPERATION, wenn das in diesem Objekt enthaltene Wissensobjekt geändert wurde, seitdem dieses Objekt erstellt wurde.
Hinweise
Der in pItemId zurückgegebene Wert ist die geschlossene Untergrenze für den Bereich von Element-IDs, die dem in piClockVector zurückgegebenen Taktvektor zugeordnet sind. Der Wert von pItemId definiert auch die geöffnete Obergrenze des vorherigen Bereichs, sodass die geöffnete Obergrenze des aktuellen Bereichs abgerufen werden kann, indem NextRange erneut aufgerufen wird. Wenn keine weiteren aufzulistenden Bereiche vorhanden sind, enthält der Bereich alle Elemente, deren IDs größer oder gleich pItemId sind.