Share via

3.2.4.2.18.5 GetQuota (Opnum 11)

  • Article

The GetQuota method returns the directory quota from the List of Persisted Directory Quotas (section 3.2.1.2) for the specified path.

 [id(FSRM_DISPID_QUOTA_MANAGER | 0x03)] HRESULT GetQuota(
   [in] BSTR path,
   [out, retval] IFsrmQuota** quota
 );

path: Contains the path to the requested directory quota.

quota: Pointer to an IFsrmQuota interface pointer (section 3.2.4.2.16) that upon completion points to the directory quota for the specified path. The caller MUST release the quota when it is done with it.

Return Values: The method MUST return zero on success, or a nonzero error code on failure.

Return value/code

Description

0x80045301

FSRM_E_NOT_FOUND

The specified quota could not be found.

0x80045304

FSRM_E_PATH_NOT_FOUND

The quota for the specified path could not be found.

0x80045306

FSRM_E_INVALID_PATH

The content of the path parameter exceeds the maximum length of 4,000 characters.

0x80070057

E_INVALIDARG

This code is returned for the following reasons:

  • The path parameter is NULL.

  • The quota parameter is NULL.

Upon receiving this message, the server MUST validate parameters:

  • Verify that quota is not NULL.

If any validation fails, the server MUST terminate processing and return a nonzero error code.

Upon successful validation of parameters, the server MUST perform the following actions or return a nonzero error code.

If a directory quota does not exist for the specified path, the server MUST return FSRM_E_NOT_FOUND.