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.

Requisitos

Vea también

Funciones de administración de archivos

LARGE_INTEGER