Función FlushViewOfFile (memoryapi.h)

Artículo
08/24/2023

Escribe en el disco un intervalo de bytes dentro de una vista asignada de un archivo.

Sintaxis

BOOL FlushViewOfFile(
  [in] LPCVOID lpBaseAddress,
  [in] SIZE_T  dwNumberOfBytesToFlush
);

Parámetros

[in] lpBaseAddress

Puntero a la dirección base del intervalo de bytes que se vacia en la representación del disco del archivo asignado.

[in] dwNumberOfBytesToFlush

Número de bytes que se van a vaciar. Si dwNumberOfBytesToFlush es cero, el archivo se vacía desde la dirección base hasta el final de la asignación.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

El vaciado de un intervalo de una vista asignada inicia la escritura de páginas desfasadas dentro de ese intervalo en el disco. Las páginas sucias son aquellas cuyo contenido ha cambiado desde que se asignó la vista de archivo. La función FlushViewOfFile no vacía los metadatos del archivo y no espera a que se devuelvan hasta que los cambios se vacían de la caché de disco de hardware subyacente y se escriben físicamente en el disco. Para vaciar todas las páginas desfasadas más los metadatos del archivo y asegurarse de que se escriben físicamente en el disco, llame a FlushViewOfFile y, a continuación, llame a la función FlushFileBuffers .

Al vaciar un archivo asignado a memoria a través de una red, FlushViewOfFile garantiza que los datos se han escrito desde el equipo local, pero no que los datos residan en el equipo remoto. El servidor puede almacenar en caché los datos en el lado remoto. Por lo tanto, FlushViewOfFile puede devolver antes de que los datos se hayan escrito físicamente en el disco.

Al modificar un archivo a través de una vista asignada, es posible que la última marca de tiempo de modificación no se actualice automáticamente. Si es necesario, el llamador debe usar SetFileTime para establecer la marca de tiempo.

En Windows Server 2012, esta función es compatible con las siguientes tecnologías.

Tecnología	Compatible
Protocolo Bloque de mensajes del servidor (SMB) 3.0	Sí
Conmutación por error transparente (TFO) de SMB 3.0	Sí
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO)	Sí
Sistema de archivos de Volumen compartido de clúster (CsvFS)	Sí
Sistema de archivos resistente a errores (ReFS)	Sí

Cuando csvFs está en pausa, esta llamada podría producir un error que indica que hay un conflicto de bloqueo.

Ejemplos

Para obtener un ejemplo, vea Lectura y escritura desde una vista de archivo.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [aplicaciones de escritorio \| aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2003 [aplicaciones de escritorio \| aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	memoryapi.h (incluya Windows.h, Memoryapi.h)
Library	onecore.lib
Archivo DLL	Kernel32.dll