Condividi tramite


Funzione CfGetSyncRootInfoByHandle (cfapi.h)

Ottiene varie caratteristiche della radice di sincronizzazione contenente un determinato file specificato da un handle di file.

Sintassi

HRESULT CfGetSyncRootInfoByHandle(
  [in]            HANDLE                  FileHandle,
  [in]            CF_SYNC_ROOT_INFO_CLASS InfoClass,
  [out]           PVOID                   InfoBuffer,
  [in]            DWORD                   InfoBufferLength,
  [out, optional] DWORD                   *ReturnedLength
);

Parametri

[in] FileHandle

Gestire il file nella radice di sincronizzazione le cui informazioni devono essere sottoposte a query.

[in] InfoClass

Tipi di informazioni radice di sincronizzazione.

[out] InfoBuffer

Puntatore a un buffer che riceverà le informazioni radice di sincronizzazione.

[in] InfoBufferLength

Lunghezza, in byte, di InfoBuffer.

[out, optional] ReturnedLength

Numero di byte restituiti in InfoBuffer.

Valore restituito

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

A differenza della maggior parte delle API segnaposto che accettano un handle di file, questa non modifica il file in alcun modo, pertanto FileHandle richiede solo l'accesso READ_ATTRIBUTES .

Se il file non è sotto una radice di sincronizzazione dei file cloud, l'API avrà esito negativo. In caso di esito positivo, le informazioni vengono restituite in base alla richiesta di InfoClass specifica.

Requisiti

Requisito Valore
Client minimo supportato Windows 10 versione 1709 [solo app desktop]
Server minimo supportato Windows Server 2016 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione cfapi.h
Libreria CldApi.lib
DLL CldApi.dll

Vedi anche

CfGetSyncRootInfoByPath