Función GetFileSizeEx (fileapi.h)

  • Artículo

Recupera el tamaño del trabajo especificado.

Sintaxis

BOOL GetFileSizeEx(
  [in]  HANDLE         hFile,
  [out] PLARGE_INTEGER lpFileSize
);

Parámetros

[in] hFile

Identificador del archivo. El identificador debe haberse creado con el derecho de acceso FILE_READ_ATTRIBUTES o equivalente, o el autor de la llamada debe tener el permiso suficiente en el directorio que contiene el archivo. Para obtener más información, vea Seguridad de archivos y derechos de acceso.

[out] lpFileSize

Puntero a una estructura de LARGE_INTEGER que recibe el tamaño del archivo, en bytes.

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

Operaciones de transacción: Si hay una transacción enlazada al identificador de archivo, la función devuelve información para la vista de archivo aislada.

Aplicaciones de la Tienda Windows: No se admite GetFileSizeEx. Use GetFileInformationByHandleEx.

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

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í

Requisitos

   
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 fileapi.h (incluya Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

Funciones de administración de archivos

LARGE_INTEGER