IMDSPStorageGlobals::GetTotalFree

The GetTotalFree method retrieves the total free space on the storage medium, in bytes.

Syntax

HRESULT GetTotalFree(
  DWORD*  pdwFreeLow,
  DWORD*  pdwFreeHigh
);

Parameters

pdwFreeLow

[out] Pointer to a double word containing the low-order part of the free space.

pdwFreeHigh

[out] Pointer to a double word containing the high-order part of the free space.

Return Values

If the method succeeds, it returns S_OK. If it fails, it returns an HRESULT error code.

Return code	Description
E_INVALIDARG	Either pdwFreeLow or pdwFreeHigh is an invalid or NULL pointer.
E_FAIL	An unspecified error occurred.

Remarks

To determine the amount of storage space in use by the medium for file management, subtract the number of bad bytes identified with GetTotalBad from the number of free bytes identified with GetTotalFree.

See Also

IMDSPStorageGlobals Interface

Previous

Next