IKnowledgeWithMarkers::NextAllChangeUnitsRequiredMarker
Retourne l'élément suivant dans la liste des éléments marqués comme nécessitant toutes les unités de modification.
HRESULT NextAllChangeUnitsRequiredMarker(
BYTE * pItemId,
DWORD * pIdSize);
Paramètres
- pItemId
[in, out, unique, size_is(*pIdSize)] Retourne l'ID d'élément suivant dans la liste des ID d'élément marqués comme nécessitant toutes les unités de modification.
- pIdSize
[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.
Valeur de retour
S_OK.
S_FALSE lorsqu'il n'y a plus d'éléments dans la liste ou lorsque l'objet de connaissance contient des éléments marqués comme contenant toutes les unités de modification.
HRESULT_FROM_WIN32(ERROR_MORE_DATA) lorsque pItemId est trop petit. Dans ce cas, le nombre requis d'octets est retourné dans pIdSize.
E_INVALIDARG lorsque pIdSize est plus grand que la taille maximale spécifiée par le schéma du format de l'ID d'élément.
E_POINTER lorsque les ID d'élément sont de longueur variable et que pIdSize a la valeur NULL.
Notes
Lorsque les filtres personnalisés sont utilisés, le fournisseur de source doit vérifier si les éléments ajoutés à un lot de modifications nécessitent que toutes les unités de modification soint incluses. Pour cela, appelez IKnowledgeWithMarkers::ContainsAllChangeUnitsRequiredMarker ou énumérez les éléments à l'aide de NextAllChangeUnitsRequiredMarker. Lorsqu'un élément est marqué comme nécessitant toutes les unités de modification, le fournisseur de source doit inclure toutes les unités de modification qui passent le filtre pour cet élément.