Función CfRevertPlaceholder (cfapi.h)

Revierte un marcador de posición a un archivo normal, quitando todas las características especiales, como la etiqueta de reanálisis, la identidad del archivo, etc.

Sintaxis

HRESULT CfRevertPlaceholder(
  [in]                HANDLE          FileHandle,
  [in]                CF_REVERT_FLAGS RevertFlags,
  [in, out, optional] LPOVERLAPPED    Overlapped
);

Parámetros

[in] FileHandle

Identificador del marcador de posición de archivo o directorio que está a punto de revertirse a un archivo o directorio normal. La plataforma sincroniza correctamente la operación de reversión con otras solicitudes activas. Un atributo o identificador sin acceso es suficiente.

[in] RevertFlags

Marcador de posición revierte las marcas. RevertFlags debe establecerse en CF_REVERT_FLAG_NONE.

[in, out, optional] Overlapped

Cuando se especifica y se combina con un FileHandle asincrónico, Superpuesta permite a la plataforma realizar la llamada CfRevertPlaceholder 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 haya creado el identificador.

Valor devuelto

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El autor de la llamada debe tener WRITE_DATA o WRITE_DAC acceso al marcador de posición que se va a revertir.

Si el marcador de posición aún no está completamente hidratado en el momento de la llamada, el filtro enviará una devolución de llamada FETCH_DATA al proveedor de sincronización para hidratar el archivo. Si el archivo no se puede hidratar, se producirá un error en la reversión con el estado STATUS_CLOUD_FILE_ACCESS_DENIED.

Si la API devuelve HRESULT_FROM_WIN32(ERROR_IO_PENDING) al usar superpuesta de forma asincrónica, el autor de la llamada puede esperar mediante 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

Consulte también

GetOverlappedResult

CF_REVERT_FLAGS