Share via

3.5 Example 5: Creating an FSRM Quota

  • Article

This example demonstrates the use cases described in section 2.5.4.3.

This example describes the creation of a File Server Resource Manager (FSRM) quota at a given path in the object store of a given server by the admin tool.

Initial System State

None.

Prerequisites

  • The participating client and server computers are configured to belong to the same Active Directory domain.

  • The admin tool has acquired an RPC calling context that provides the FSRM server ([MS-FSRM] section 2.1).

Final System State

The FSRM Service successfully executes the requested operations, and the specified file quota policy is created on the server.

The following sequence diagram shows the steps to create an FSRM quota.

Sequence diagram for creating an FSRM quota

Figure 18: Sequence diagram for creating an FSRM quota

Sequence of Events

  1. The admin client queries the server to determine if there is an existing quota that is specified on the object store path. To do this, it calls the IFsrmQuotaManager::GetQuota method ([MS-FSRM] section 3.2.4.2.18.5) by retrieving a potentially non-empty existing IFsrmQuota object. If an IFsrmQuota object is returned, the admin tool determines that no quota is currently configured on the server at the specified path.

  2. The admin client creates an empty IFsrmQuota object by using the IFsrmQuotaManager::CreateQuota method ([MS-FSRM] section 3.2.4.2.18.3). The FSRM Service returns the reference to the newly created quota object and a success code.

  3. The admin client modifies the returned IFsrmQuota object to reflect the specified quota limit by using the IFsrmQuotaBase::QuotaLimit(put) method ([MS-FSRM] section 3.2.4.2.14.3). The FSRM Service returns a success code.

  4. To complete the operation, the admin client instructs the server to commit the modifications to the quota by using the IFsrmQuotaObject::Commit method ([MS-FSRM] section 3.2.4.2.15.1). The FSRM Service returns a success code.