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

Voir aussi

CF_CALLBACK_INFO