Kernel32GetCompressedFileSize Method

Retrieves the actual number of bytes of disk storage used to store a specified file.

If the file is located on a volume that supports compression and the file is compressed, the value obtained is the compressed size of the specified file.

If the file is located on a volume that supports sparse files and the file is a sparse file, the value obtained is the sparse size of the specified file.

Definition

Namespace: DevCase.Win32.NativeMethods
Assembly: DevCase.net48 (in DevCase.net48.dll) Version: 6.0.0.0 (6.0)
XMLNS for XAML: Not mapped to an xmlns.
[DllImportAttribute("Kernel32.dll", CharSet = CharSet.Auto, BestFitMapping = false, 
	ThrowOnUnmappableChar = true, SetLastError = true)]
public static uint GetCompressedFileSize(
	string fileName,
	out uint refFileSizeHigh
)

Parameters

fileName  String
The name of the file.

Do not specify the name of a file on a nonseeking device, such as a pipe or a communications device, as its file size has no meaning.

This parameter may include the path. In the ANSI version of this function, the name is limited to MAX_PATH characters. To extend this limit to 32,767 wide characters, call the Unicode version of the function and prepend "\?" to the path.

refFileSizeHigh  UInt32
The high-order DWORD of the compressed file size.

The function's return value is the low-order DWORD of the compressed file size.

This parameter can be NULL if the high-order DWORD of the compressed file size is not needed.

Files less than 4 gigabytes in size do not need the high-order DWORD.

Return Value

UInt32
If the function succeeds, the return value is the low-order DWORD of the actual number of bytes of disk storage used to store the specified file, and if lpFileSizeHigh is non-NULL, the function puts the high-order DWORD of that actual value into the DWORD pointed to by that parameter. This is the compressed file size for compressed files, the actual file size for noncompressed files.

If the function fails, and refFileSizeHigh is NULL, the return value is INVALID_FILE_SIZE.

If the return value is INVALID_FILE_SIZE and refFileSizeHigh is non-NULL, an application must call GetLastError to determine whether the function has succeeded (value is NO_ERROR) or failed (value is other than NO_ERROR).

Remarks

See Also