ICoreFragment::NextRange
Retourne la plage suivante contenue dans ce fragment de connaissance et le vecteur horloge qui définit ce qui est connu concernant les éléments contenus dans la plage.
HRESULT NextRange(
BYTE* pItemId,
DWORD* pItemIdSize,
IClockVector** piClockVector);
Paramètres
- pItemId
[in, out, unique, size_is(*pItemIdSize)] Retourne la limite inférieure fermée des ID d'élément contenus dans cette plage. Cette valeur est également la limite supérieure ouverte des ID d'élément contenus dans la plage précédente lorsque cette plage n'est pas la première plage de l'ensemble de plages.
- pItemIdSize
[in, out] Spécifie le nombre d'octets contenus dans pItemId. Retourne le nombre d'octets requis pour récupérer l'ID lorsque pItemId est trop petit, ou le nombre d'octets écrits.
- piClockVector
[out] Retourne le vecteur horloge qui définit ce qui est connu concernant les éléments contenus dans la plage.
Valeur de retour
S_OK
S_FALSE lorsqu'il n'y a plus de plages à énumérer.
E_POINTER lorsque l'ID d'élément est un ID de longueur variable et que pItemIdSize a la valeur NULL.
HRESULT_FROM_WIN32(ERROR_MORE_DATA) lorsque pItemId est trop petit. Dans cette situation, le nombre requis d'octets est retourné dans pItemIdSize.
SYNC_E_INVALID_OPERATION si l'objet de connaissance contenu dans cet objet a été modifié depuis la création de ce dernier.
Notes
La valeur retournée dans la propriété pItemId est la limite inférieure fermée sur la plage des ID d'élément associés au vecteur horloge retourné dans la propriété piClockVector. La valeur de pItemId définit également la limite supérieure ouverte de la plage précédente. Par conséquent, la limite supérieure ouverte de la plage actuelle peut être obtenue en appelant à nouveau NextRange. S'il n'y a plus de plages à énumérer, la plage contient tous les éléments qui ont des ID supérieurs ou égaux à pItemId.