3.2.4.2.18.6 GetAutoApplyQuota (Opnum 12)
The GetAutoApplyQuota method returns the auto apply quota from the List of Persisted Auto Apply Quotas (section 3.2.1.2) for the specified path.
-
[id(FSRM_DISPID_QUOTA_MANAGER | 0x04)] HRESULT GetAutoApplyQuota( [in] BSTR path, [out, retval] IFsrmAutoApplyQuota** quota );
path: Contains the path to the requested auto apply quota.
quota: Pointer to an IFsrmAutoApplyQuota interface pointer (section 3.2.4.2.17) that upon completion points to the auto apply 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 auto apply quota could not be found.
0x80045304
FSRM_E_PATH_NOT_FOUND
The auto apply 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 260 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.
Create a new Non-Persisted Auto Apply Quota Instance and populate its configuration and state data from the Persisted Auto Apply Quota (section 3.2.1.2.2.1) in the List of Persisted Auto Apply Quotas with the specified path.
Set quota to the IFsrmAutoApplyQuota interface of the new Non-Persisted Auto Apply Quota Instance.
If an auto apply quota does not exist for the specified path, the server MUST return FSRM_E_NOTFOUND.