GetSpaceUsed
Collapse the table of content
Expand the table of content

IEmptyVolumeCache::GetSpaceUsed method

Requests the amount of disk space that the disk cleanup handler can free.

Syntax


HRESULT GetSpaceUsed(
  [out] DWORDLONG                 *pdwSpaceUsed,
  [in]  IEmptyVolumeCacheCallback *picb
);

Parameters

pdwSpaceUsed [out]

Type: DWORDLONG*

The amount of disk space, in bytes, that the handler can free. This value will be displayed in the disk cleanup manager's list, to the right of the handler's check box. To indicate that you do not know how much disk space can be freed, set this parameter to -1, and "???MB" will be displayed. If you set the EVCF_DONTSHOWIFZERO flag when Initialize was called, setting pdwSpaceUsed to zero will notify the disk cleanup manager to omit the handler from its list.

picb [in]

Type: IEmptyVolumeCacheCallback*

A pointer to the disk cleanup manager's IEmptyVolumeCacheCallback interface. This pointer can be used to call that interface's ScanProgress method to report on the progress of the operation.

Return value

Type: HRESULT

This method can return one of these values.

Return codeDescription
S_OK

Success.

S_FALSE

An error occurred when the handler tried to calculate the amount of disk space that could be freed.

E_ABORT

The scan operation was ended prematurely. This value is usually returned when a call to ScanProgress returns E_ABORT. This return value indicates that the user canceled the operation by clicking the disk cleanup manager's Cancel button.

 

Remarks

When this method is called by the disk cleanup manager, the handler should start scanning its files to determine which of them can be deleted, and how much disk space will be freed. Handlers should call IEmptyVolumeCache::ScanProgress periodically to keep the user informed of the progress of the scan, especially if it will take a long time. Calling this method frequently also allows the handler to determine whether the user has canceled the operation. If ScanProgress returns E_ABORT, the user has canceled the scan. The handler should immediately stop scanning and return E_ABORT.

You should only set the pdwSpaceUsed parameter to -1 as a last resort. The handler is of limited value to a user if they don't know how much space will be freed.

Requirements

Minimum supported client

Windows 2000 Professional, Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Emptyvc.h

DLL

Shell32.dll (version 5.0 or later)

 

 

Show:
© 2016 Microsoft