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 | 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í |
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 |