Función CfHydratePlaceholder (cfapi.h)
Hidrata un archivo de marcador de posición asegurándose de que el intervalo de bytes especificado está presente en el disco en el marcador de posición. Esto solo es válido para archivos.
Sintaxis
HRESULT CfHydratePlaceholder(
[in] HANDLE FileHandle,
[in] LARGE_INTEGER StartingOffset,
[in] LARGE_INTEGER Length,
[in] CF_HYDRATE_FLAGS HydrateFlags,
[in, out, optional] LPOVERLAPPED Overlapped
);
Parámetros
[in] FileHandle
Identificador del archivo de marcador de posición que se va a hidratar. Un atributo o un identificador de acceso no es suficiente.
[in] StartingOffset
Desplazamiento de punto inicial de los datos del archivo de marcador de posición.
[in] Length
Longitud, en bytes, del archivo de marcador de posición cuyos datos deben estar disponibles localmente en el disco después de que la API se complete correctamente. Una longitud de CF_EOF (definida como -1) significa el final del archivo. Para cualquier subrango que no esté presente en el marcador de posición, la plataforma capturará los datos del proveedor de sincronización y lo almacenará en el disco en el marcador de posición.
[in] HydrateFlags
Marcas de hidratación del marcador de posición. HydrateFlags debe establecerse en CF_HYDRATE_FLAG_NONE.
[in, out, optional] Overlapped
Cuando se especifica y se combina con un FileHandle asincrónico, Superpuesto permite a la plataforma realizar la llamada cfHydratePlaceholder de forma asincrónica. Consulte los comentarios para obtener más detalles.
Si no se especifica, la plataforma realizará la llamada API de forma sincrónica, independientemente de cómo se creó el identificador.
Valor devuelto
Si esta función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
El autor de la llamada debe tener READ_DATA o WRITE_DAC acceso al marcador de posición que se va a hidratar.
Si la API devuelve HRESULT_FROM_WIN32(ERROR_IO_PENDING) cuando se usa superpuesta de forma asincrónica, el autor de la llamada puede esperar con GetOverlappedResult.
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 |