IFsrmAutoApplyQuota.CommitAndUpdateDerived Method (_FsrmCommitOptions, _FsrmTemplateApplyOptions)

 

Saves the quota and then applies any changes to the derived quotas.

Namespace:   Microsoft.Storage
Assembly:  srmlib (in srmlib.dll)

Syntax

IFsrmDerivedObjectsResult CommitAndUpdateDerived(
    _FsrmCommitOptions commitOptions,
    _FsrmTemplateApplyOptions applyOptions
)

IFsrmDerivedObjectsResult^ CommitAndUpdateDerived(
    _FsrmCommitOptions commitOptions,
    _FsrmTemplateApplyOptions applyOptions
)

abstract CommitAndUpdateDerived : 
        commitOptions:_FsrmCommitOptions *
        applyOptions:_FsrmTemplateApplyOptions -> IFsrmDerivedObjectsResult

Function CommitAndUpdateDerived (
    commitOptions As _FsrmCommitOptions,
    applyOptions As _FsrmTemplateApplyOptions
) As IFsrmDerivedObjectsResult

Parameters

• commitOptions
  Type: Microsoft.Storage._FsrmCommitOptions

  The options for saving the quota. For possible values, see the _FsrmCommitOptions enumeration.

• applyOptions
  Type: Microsoft.Storage._FsrmTemplateApplyOptions

  The options used to choose the derived quotas to which the changes are applied. For possible values, see the _FsrmTemplateApplyOptions enumeration.

Return Value

Type: Microsoft.Storage.IFsrmDerivedObjectsResult

Returns a IFsrmDerivedObjectsResult that you use to determine the list of derived objects that were updated and whether the update was successful.

Remarks

In this context, a derived quota is any quota that is applied to a subdirectory of the automatic quota directory. For example, if you create an automatic quota for c:\folder1 and if folder1 has subdirectories of c:\folder1\subfolder1, c:\folder1\subfolder2, and c:\folder1\subfolder3, then a quota that exists on subfolder1, subfolder2, or subfolder3 is considered a derived quota.

You would call this method if you called the ApplyTemplate method to change the source template for the automatic quota. Calling the CommitAndUpdateDerived method would then propagate the new template's settings to the existing quotas under the automatic quota directory.

If you specify the FsrmTemplateApplyOptions_ApplyToDerivedAll option, FSRM will create a quota for all immediate subdirectories that do not have a quota applied to them and will update any existing quotas using the properties of the automatic quota, whether the quota was created from the automatic quota or not. For example, if a quota in one of the subdirectories was originally derived from a template, the quota is considered a derived quota and is updated using the automatic quota—the quota is no longer considered derived from the template.

For an example, see Updating a Quota.

See Also

IFsrmAutoApplyQuota Interface
Microsoft.Storage Namespace

Return to top