Partager via


Fonction CfGetCorrelationVector (cfapi.h)

Permet au fournisseur de synchronisation d’interroger le vecteur de corrélation actuel pour un fichier d’espace réservé donné. Il s’agit soit de celui attribué automatiquement par la plateforme lors de la première ouverture du fichier, soit explicitement attribué via CfSetCorrelationVector.

Syntaxe

HRESULT CfGetCorrelationVector(
  [in]  HANDLE              FileHandle,
  [out] 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.

[out] CorrelationVector

Vecteur de corrélation actuellement associé à FileHandle.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

L’appelant doit avoir READ_DATA ou WRITE_DAC accès à l’espace réservé à hydrater. Sinon, l’opération échoue avec STATUS_CLOUD_FILE_ACCESS_DENIED.

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

Voir aussi

CfSetCorrelationVector