Funzione GetFileInformationByHandle (fileapi.h)

  • Articolo

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

Vedere anche

Funzioni di gestione file

GetFileInformationByHandleEx

SetFileInformationByHandle