Export (0) Print
Expand All

I_IrmPolicyInfoRMS.HrGetICrypt Method

Published: May 2010

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 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 method fails, the protector cannot recover from the error and also fails.

The actual encryption and decryption of rights-managed documents is performed by the I_IrmCrypt object, not the integrated Information Rights Management (IRM) protector itself. The I_IrmCrypt 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 object instantiated for the current document.

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

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

Community Additions

ADD
Show:
© 2014 Microsoft