ICoreFragment::NextRange

Restituisce l'intervallo successivo contenuto in questo frammento di conoscenza e il vettore di clock che definisce cosa è noto in relazione agli elementi dell'intervallo.

HRESULT NextRange(
  BYTE* pItemId,
  DWORD* pItemIdSize,
  IClockVector** piClockVector);

Parametri

• pItemId
  [in, out, unique, size_is(*pItemIdSize)] Restituisce il limite inferiore chiuso degli ID elemento in questo intervallo. Questo valore rappresenta anche il limite superiore aperto degli ID elemento nell'intervallo precedente quando quest'ultimo non è il primo intervallo del set.

• pItemIdSize
  [in, out] Specifica il numero di byte in pItemId. Restituisce il numero di byte necessari per recuperare l'ID se pItemId è troppo piccolo oppure il numero di byte scritti.

• piClockVector
  [out] Restituisce il vettore di clock che definisce cosa è noto in relazione agli elementi nell'intervallo.

Valore restituito

• S_OK

• S_FALSE se non ci sono più intervalli da enumerare.

• E_POINTER se l'ID elemento è un ID a lunghezza variabile e pItemIdSize è NULL.

• HRESULT_FROM_WIN32 (ERROR_MORE_DATA) se pItemId è troppo piccolo. In questo caso, il numero necessario di byte viene restituito in pItemIdSize.

• SYNC_E_INVALID_OPERATION se l'oggetto conoscenza contenuto in questo oggetto è stato modificato dalla creazione di questo oggetto.

Osservazioni

Il valore restituito in pItemId corrisponde al limite inferiore chiuso dell'intervallo di ID elemento associati al vettore di clock restituito in piClockVector. Il valore di pItemId definisce anche il limite superiore aperto dell'intervallo precedente, pertanto è possibile ottenere il limite superiore aperto dell'intervallo corrente chiamando nuovamente NextRange. In mancanza di intervalli da enumerare, l'intervallo contiene tutti gli elementi con ID superiori o uguali a pItemId.

Vedere anche

Riferimento

Interfaccia ICoreFragment