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 |