Función GetFileInformationByHandle (fileapi.h)

Recupera información del archivo especificado.

Para obtener una versión más avanzada de esta función, consulte GetFileInformationByHandleEx.

Para establecer información de archivo mediante un identificador de archivo, vea SetFileInformationByHandle.

Sintaxis

BOOL GetFileInformationByHandle(
  [in]  HANDLE                       hFile,
  [out] LPBY_HANDLE_FILE_INFORMATION lpFileInformation
);

Parámetros

[in] hFile

Identificador del archivo que contiene la información que se va a recuperar.

Este identificador no debe ser un identificador de canalización.

[out] lpFileInformation

Puntero a una estructura BY_HANDLE_FILE_INFORMATION que recibe la información del archivo.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es distinto de cero y los datos de información del archivo se encuentran en el búfer al que apunta el parámetro lpFileInformation .

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

Comentarios

Dependiendo de las características de red subyacentes del sistema operativo y del tipo de servidor al que está conectado, la función GetFileInformationByHandle puede producir un error, devolver información parcial o información completa para el archivo especificado.

Puede comparar los miembros VolumeSerialNumber y FileIndex devueltos en la estructura BY_HANDLE_FILE_INFORMATION para determinar si dos rutas de acceso se asignan al mismo destino; por ejemplo, puede comparar dos rutas de acceso de archivo y determinar si se asignan al mismo directorio.

IIn Windows 8 y 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
Conmutación por error transparente (TFO) de SMB 3.0
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO)
Sistema de archivos de Volumen compartido de clúster (CsvFS)
Sistema de archivos resistente a errores (ReFS)
 

Operaciones de transacción

Si hay una transacción enlazada al subproceso en el momento de la llamada, la función devuelve el tamaño de archivo comprimido de la vista de archivo aislada. Para obtener más información, vea Acerca de NTFS transaccional.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado fileapi.h (incluye Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

Funciones de administración de archivos

GetFileInformationByHandleEx

SetFileInformationByHandle