IAnchorSyncProvider::GetEnumerationAnchor
Appelé à la fin de chaque lot de modifications et de la validation manuelle des connaissances sur le fournisseur de destination pour retourner une ancre d'énumération utilisée pour déterminer le prochain ensemble de modifications à synchroniser.
Syntaxe
HRESULT GetEnumerationAnchor(
BYTE *pAnchor,
ULONG *pcbAnchor);
Paramètres
pAnchor
[in, out, unique, size_is(*pcbAnchor)] Retourne une ancre d'énumération utilisée pour déterminer le prochain ensemble de modifications à synchroniser. Retourne Null si l'ancre n'a pas changé.pcbAnchor
[in, out] Spécifie le nombre d'octets contenus dans pAnchor. Retourne le nombre d'octets requis pour récupérer l'ID lorsque pAnchor est trop petit, ou le nombre d'octets écrits.
Valeur de retour
S_OK
HRESULT_FROM_WIN32(ERROR_MORE_DATA) lorsque pAnchor est trop petit. Dans ce cas, le nombre requis d'octets est retourné dans pcbAnchor.
Notes
En général, cette méthode est appelée deux fois de suite. Pour le premier appel, pAnchor est NULL et pcbAnchor pointe vers une valeur égale à zéro. En réponse à cet appel, cette méthode retourne la taille nécessaire de pAnchor dans pcbAnchor. Pour le second appel, pAnchor pointe vers un tableau d'octets de taille pcbAnchor auquel cette méthode ajoute l'ancre d'énumération.