Función GetFileSizeEx (fileapi.h)
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 |