Funzione GetFileInformationByHandle (fileapi.h)

Recupera le informazioni sui file per il file specificato.

Per una versione più avanzata di questa funzione, vedi 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 per il file che contiene 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, 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 corrispondono alla stessa destinazione; Ad esempio, è possibile confrontare due percorsi di file e determinare se eseguono il mapping 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 di scalabilità orizzontale (SO)	Sì
File system del volume condiviso cluster (CsvFS)	Sì
Resilient File System (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

Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	fileapi.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll

Vedere anche

Funzioni di gestione file

GetFileInformationByHandleEx

SetFileInformationByHandle