Funzione GetFileSizeEx (fileapi.h)
Recupera le dimensioni del file specificato.
Sintassi
BOOL GetFileSizeEx(
[in] HANDLE hFile,
[out] PLARGE_INTEGER lpFileSize
);
Parametri
[in] hFile
Handle per il file. L'handle deve essere stato creato con il diritto di accesso FILE_READ_ATTRIBUTES o equivalente oppure il chiamante deve disporre di autorizzazioni sufficienti per la directory che contiene il file. Per altre informazioni, vedere Protezione dei file e diritti di accesso.
[out] lpFileSize
Puntatore a una struttura LARGE_INTEGER che riceve le dimensioni del file, in byte.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Operazioni transazionate: Se è presente una transazione associata all'handle di file, la funzione restituisce informazioni per la visualizzazione file isolata.
App di Windows Store: GetFileSizeEx non è supportata. Usa GetFileInformationByHandleEx.
In 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ì |
Requisiti
| Client minimo supportato | Windows XP [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2003 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | fileapi.h (include Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |