Funzione GetFileInformationByHandle (fileapi.h)
Recupera le informazioni sui file per il file specificato.
Per una versione più avanzata di questa funzione, vedere GetFileInformationByHandleEx.
Per impostare le informazioni sui file usando un handle di file, vedere SetFileInformationByHandle.
Sintassi
BOOL GetFileInformationByHandle(
[in] HANDLE hFile,
[out] LPBY_HANDLE_FILE_INFORMATION lpFileInformation
);
Parametri
[in] hFile
Handle al file contenente le informazioni da recuperare.
Questo handle non deve essere un handle pipe.
[out] lpFileInformation
Puntatore a una struttura BY_HANDLE_FILE_INFORMATION che riceve le informazioni sul file.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero e i dati delle informazioni sui file sono contenuti nel buffer a cui punta il parametro lpFileInformation .
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
A seconda delle funzionalità di rete sottostanti del sistema operativo e del tipo di server connesso a, la funzione GetFileInformationByHandle potrebbe non riuscire, restituire informazioni parziali o informazioni complete per il file specificato.
È possibile confrontare i membri VolumeSerialNumber e FileIndex restituiti nella struttura BY_HANDLE_FILE_INFORMATION per determinare se due percorsi vengono mappati alla stessa destinazione; Ad esempio, è possibile confrontare due percorsi di file e determinare se vengono mappati alla stessa directory.
IIn Windows 8 e Windows Server 2012, questa funzione è supportata dalle tecnologie seguenti.
| Tecnologia | Supportato |
|---|---|
| Protocollo SMB (Server Message Block) 3.0 | Sì |
| Failover trasparente SMB 3.0 (TFO) | Sì |
| SMB 3.0 con condivisioni file con scalabilità orizzontale (SO) | Sì |
| File system del volume condiviso del cluster (CsvFS) | Sì |
| File system resiliente (ReFS) | Sì |
Operazioni transazionate
Se è presente una transazione associata al thread al momento della chiamata, la funzione restituisce le dimensioni del file compresso della visualizzazione file isolata. Per altre informazioni, vedere Informazioni su NTFS transazionale.Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | fileapi.h (includere Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |