I_IrmPolicyInfoRMS.HrSetSignedIL Method
Applies to: SharePoint Foundation 2010
Sets the signed issuance license (IL) of the protected document.
HRESULT HrSetSignedIL(
BSTR bstrIL
) PURE;
Parameters
bstrIL
[in] The IL of the protected document.
Return Value
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.
In general, if an I_IrmPolicyInfoRMS method fails, the protector cannot recover from the error and also fails.
Remarks
To decrypt data inside a rights-managed file, Microsoft SharePoint Foundation 2010 needs both the document IL and the server end-user license (EUL). An integrated Information Rights Management (IRM) protector can use this method to set the IL of a protected document. SharePoint Foundation uses the IL to determine whether the document is being uploaded to the correct document library and to set up the decryption process.
Both the document IL and server EUL are stored inside the rights-managed file. The HrUnprotect method of the invoked IRM protector must be able to extract both of these certificates from the protected document. The HrUnprotect method can then call HrSetSignedIL to set the IL for SharePoint Foundation, and HrSetServerEUL to set the server EUL.
The HrUnprotect method is not responsible for modifying the IL in any way. SharePoint Foundation calls the Rights Management Services (RMS) server to validate the IL certificate by using the RMS private key.
For more information about integrated IRM protectors, see Custom IRM Protectors.