This documentation is archived and is not being maintained.

I_IrmPolicyInfoRMS.HrGetICrypt Method

Windows SharePoint Services 3

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.

Gets a cryptographic object capable of encoding and decoding the specified document.


HRESULT HrGetICrypt(
    I_IrmCrypt **piic
) PURE;

piic

[out] A cryptographic object capable of encoding and decoding the specified document.

All I_IrmPolicyInfoRMS Class methods return HRESULT values. A positive OK value indicates the operation succeeded. A negative return value indicates that the function did not succeed.

Some functions return more robust error codes, but these codes are not enumerated here. In general, if an I_IrmPolicyInfoRMS Class method fails, the protector will not be able to recover from the error and will fail as well.

The actual encryption and decryption of rights-managed documents is performed by the I_IrmCrypt Class object, rather than the integrated Information Rights Management (IRM) protector itself. In addition, the I_IrmCrypt Class object also performs the encoding and decoding of unencrypted data included in the protected document.

When creating a protected document, an integrated protector can immediately use this method to access the I_IrmCrypt Class object instantiated for the current document.

When an IRM protector generates an unprotected version of a document, the protector must call the I_IrmPolicyInfoRMS.HrSetSignedIL Method method before accessing the I_IrmCrypt Class object returned by this method. We strongly recommend that the protector also call I_IrmPolicyInfoRMS.HrSetServerEUL Method method before accessing the I_IrmCrypt Class object returned by this method.

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

Show: