IFsrmQuotaManager::EnumQuotas method (fsrmquota.h)

Article
10/13/2021

[This method is supported for compatibility but it's recommended to use the FSRM WMI Classes to manage FSRM. Please see the MSFT_FSRMQuota class.]

Enumerates the quotas for the specified directory and any quotas associated with its subdirectories (recursively).

Syntax

HRESULT EnumQuotas(
  [in]  BSTR                       path,
  [in]  FsrmEnumOptions            options,
  [out] IFsrmCommittableCollection **quotas
);

Parameters

[in] path

The local directory path that is associated with the quota that you want to enumerate. The string is limited to 260 characters.

If the path ends with "*", retrieve all quotas associated with the immediate subdirectories of the path (does not include the quota associated with the path).

If the path ends with "...", retrieve the quota for the path and all quotas associated with the immediate subdirectories of the path (recursively).

If the path does not end in "*" or "...", retrieve the quota for the path only.

If path is null or empty, the method returns all quotas.

[in] options

Options to use when enumerating the quotas. For possible values, see the FsrmEnumOptions enumeration.

[out] quotas

An IFsrmCommittableCollection interface that contains a collection of the quotas.

Each item of the collection is a VARIANT of type VT_DISPATCH. Query the pdispVal member of the variant for the IFsrmQuota interface.

The collection is empty if the path does not contain quotas.

Return value

The method returns the following return values.

Remarks

To enumerate quotas that apply automatically to the path's subdirectories, call the IFsrmQuotaManager::EnumAutoApplyQuotas method.

Requirements

Requirement	Value
Minimum supported client	None supported
Minimum supported server	Windows Server 2008
Target Platform	Windows
Header	fsrmquota.h (include FsrmQuota.h, FsrmTlb.h)
DLL	SrmSvc.dll