GetFileSizeEx 函式 (fileapi.h)

擷取指定檔案的大小。

語法

BOOL GetFileSizeEx(
  [in]  HANDLE         hFile,
  [out] PLARGE_INTEGER lpFileSize
);

參數

[in] hFile

檔案的控制碼。 控制碼必須以 FILE_READ_ATTRIBUTES 存取權限或對等專案建立，否則呼叫端必須具有包含檔案之目錄的足夠許可權。 如需詳細資訊，請參閱 檔案安全性和存取權限。

[out] lpFileSize

接收檔案大小的 LARGE_INTEGER 結構的指標，以位元組為單位。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

交易作業： 如果有系結至檔案控制碼的交易，則函式會傳回隔離檔案檢視的資訊。

Windows 市集應用程式：不支援GetFileSizeEx。 使用 GetFileInformationByHandleEx。

在 Windows 8 和 Windows Server 2012 中，下列技術支援此函式。

技術	支援
伺服器訊息區 (SMB) 3.0 通訊協定	是
SMB 3.0 透明容錯移轉 (TFO)	是
具有向外延展檔案共用的 SMB 3.0 (SO)	是
叢集共用磁片區檔案系統 (CsvFS)	是
彈性檔案系統 (ReFS)	是

需求

最低支援的用戶端	Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	fileapi.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll

另請參閱

檔案管理功能

LARGE_INTEGER