Fonction CfSetCorrelationVector (cfapi.h)
Permet à un fournisseur de synchronisation d’indiquer à la plateforme d’utiliser un vecteur de corrélation spécifique à des fins de télémétrie sur un fichier d’espace réservé. Ce paramètre est facultatif.
Syntaxe
HRESULT CfSetCorrelationVector(
[in] HANDLE FileHandle,
[in] const PCORRELATION_VECTOR CorrelationVector
);
Paramètres
[in] FileHandle
Handle du fichier d’espace réservé. La plateforme synchronise correctement l’opération avec d’autres requêtes actives. Un attribut ou un handle sans accès est suffisant.
[in] CorrelationVector
Vecteur de corrélation spécifique à associer au FileHandle.
Valeur retournée
Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
La plateforme affecte automatiquement un vecteur de corrélation à chaque fichier lors de sa première ouverture et fournit ce vecteur de corrélation avec chaque rappel au fournisseur de synchronisation dans le cadre de la CF_CALLBACK_INFO commune. Il est suggéré que le moteur de synchronisation appelle cette fonction pour incrémenter le dernier chiffre du vecteur de corrélation « horloge » à mesure que le fournisseur de synchronisation progresse au cours des étapes internes (telles que définies par le fournisseur de synchronisation) pour satisfaire la demande.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 10, version 1709 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2016 (applications de bureau uniquement) |
| Plateforme cible | Windows |
| En-tête | cfapi.h |
| Bibliothèque | CldApi.lib |
| DLL | CldApi.dll |