Función CfGetSyncRootInfoByHandle (cfapi.h)
Obtiene varias características de la raíz de sincronización que contiene un archivo determinado especificado por un identificador de archivo.
Sintaxis
HRESULT CfGetSyncRootInfoByHandle(
[in] HANDLE FileHandle,
[in] CF_SYNC_ROOT_INFO_CLASS InfoClass,
[out] PVOID InfoBuffer,
[in] DWORD InfoBufferLength,
[out, optional] DWORD *ReturnedLength
);
Parámetros
[in] FileHandle
Identificador del archivo en la raíz de sincronización cuya información se va a consultar.
[in] InfoClass
Tipos de información raíz de sincronización.
[out] InfoBuffer
Puntero a un búfer que recibirá la información raíz de sincronización.
[in] InfoBufferLength
Longitud, en bytes, de InfoBuffer.
[out, optional] ReturnedLength
Número de bytes devueltos en InfoBuffer.
Valor devuelto
Si esta función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
A diferencia de la mayoría de las API de marcador de posición que toman un identificador de archivo, esta no modifica el archivo de ninguna manera, por lo que FileHandle solo requiere READ_ATTRIBUTES acceso.
Si el archivo no está debajo de una raíz de sincronización de archivos en la nube, se producirá un error en la API. Si se ejecuta correctamente, la información se devuelve según la información específica solicitada.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 10, versión 1709 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2016 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | cfapi.h |
| Library | CldApi.lib |
| Archivo DLL | CldApi.dll |