ISyncFilter::Serialize
En cas de substitution par une classe dérivée, sérialise le filtre en un tableau d'octets.
HRESULT Serialize(
BYTE * pbSyncFilter,
DWORD * pcbSyncFilter);
Paramètres
- pbSyncFilter
[in, out, unique, size_is(*pcbSyncFilter)] Tableau d'octets qui reçoit les données de filtre.
- pcbSyncFilter
[in, out] Spécifie le nombre d'octets contenus dans pbSyncFilter. Retourne le nombre d'octets requis pour pbSyncFilter lorsque pbSyncFilter est trop petit, ou le nombre d'octets écrits dans pbSyncFilter lorsque des données sont écrites.
Valeur de retour
S_OK.
HRESULT_FROM_WIN32(ERROR_MORE_DATA) lorsque pbChangeBatch est trop petit. Dans ce cas, le nombre requis d'octets est stocké dans pcbChangeBatch.
Codes d'erreur déterminés par le fournisseur.
Notes
La première fois que Sync Framework appelle cette méthode, il spécifie NULL pour pbSyncFilter et 0 pour pcbSyncFilter. Dans ce cas, l'implémentation doit retourner la taille correcte pour l'ID d'élément dans pcbSyncFilter, et un code d'erreur de HRESULT_FROM_WIN32(ERROR_MORE_DATA).
Lorsque cette méthode est implémentée, le développeur doit également implémenter ISyncFilterDeserializer::DeserializeSyncFilter pour désérialiser les données sérialisées.
S'il n'est pas nécessaire de sérialiser le filtre, cette méthode peut retourner E_NOTIMPL.