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
Failover trasparente SMB 3.0 (TFO)
SMB 3.0 con condivisioni file di scalabilità orizzontale (SO)
File system del volume condiviso cluster (CsvFS)
Resilient File System (ReFS)

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

Vedere anche

Funzioni di gestione file

LARGE_INTEGER