Partager via


Fonction CfGetSyncRootInfoByPath (cfapi.h)

Obtient diverses informations de racine de synchronisation en fonction d’un fichier sous la racine de synchronisation.

Syntaxe

HRESULT CfGetSyncRootInfoByPath(
  [in]            LPCWSTR                 FilePath,
  [in]            CF_SYNC_ROOT_INFO_CLASS InfoClass,
  [out]           PVOID                   InfoBuffer,
  [in]            DWORD                   InfoBufferLength,
  [out, optional] DWORD                   *ReturnedLength
);

Paramètres

[in] FilePath

Chemin d’accès complet à un fichier dont les informations racine de synchronisation doivent être interrogées.

[in] InfoClass

Types d’informations racine de synchronisation.

[out] InfoBuffer

Pointeur vers une mémoire tampon qui recevra les informations de la racine de synchronisation.

[in] InfoBufferLength

Longueur, en octets, de l’InfoBuffer.

[out, optional] ReturnedLength

Longueur, en octets, des informations racine de synchronisation retournées. Reportez-vous à CfRegisterSyncRoot pour plus d’informations sur la racine de synchronisation.

Valeur retournée

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

Notes

Si le fichier ne se trouve pas sous une racine de synchronisation de fichiers cloud, l’API échoue. En cas de réussite, les informations sont retournées en fonction de l’InfoClasse spécifique demandée.

Le paramètre InfoClass peut être l’une des valeurs suivantes de CF_SYNC_ROOT_INFO_CLASS :

  • CF_SYNC_ROOT_INFO_BASIC
  • CF_SYNC_ROOT_INFO_STANDARD
  • CF_SYNC_ROOT_INFO_PROVIDER

Configuration requise

   
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

CfRegisterSyncRoot

CfGetSyncRootInfoByHandle