I_IrmProtector Interface

  • Article

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

Represents the interface that a COM object must implement to act as an Information Rights Management (IRM) protector in Windows SharePoint Services.

I_IrmProtector: public IUnknown

Remarks

Each IRM protector must be a COM component that implements the I_IrmProtector interface. Implementing this interface guarantees that the protector provides Windows SharePoint Services with the functionality it needs to manage the rights of documents of the specified file types.

While both integrated and autonomous protectors must implement the I_IrmProtector interface, each type of protector implements the interface differently, because Windows SharePoint Services calls the two types using different methods of the interface. Windows SharePoint Services invokes integrated protectors using the I_IrmProtector.HrProtectRMS Method and I_IrmProtector.HrUnprotectRMS Method methods, while it invokes autonomous protectors using the I_IrmProtector.HrProtect Method and I_IrmProtector.HrUnprotect Method methods. This enables Windows SharePoint Services to pass the appropriate information to each type of protector:

  • For integrated protectors, this includes an I_IrmPolicyInfoRMS Class object, which represents methods and data that a custom integrated IRM protector can access to assist in the encryption and decryption of rights-managed files.

  • For autonomous protectors, this includes an I_IrmPolicyInfo Class object, which represents the rights management metadata that an autonomous IRM protector can access to rights manage files.

For more information about integrated and autonomous protectors, see Custom IRM Protectors.

After you have compiled your custom IRM protector, you must register that protector with Windows SharePoint Services so that it can be made available for document libraries.

For information about registering IRM protectors, see How to: Register an IRM Protector.

See Also

Reference

I_IrmPolicyInfoRMS Class

I_IrmPolicyInfo Class

Concepts

Information Rights Management in Windows SharePoint Services Overview