I_IrmPolicyInfo.HrGetURL Method

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 the URL of the document library in which the requested file is located.

HRESULT HrGetURL(
    BSTR*  pbstrURL
    );

Parameters

pbstrURL

[out] The URL of the document library in which the requested file is located.

Return Value

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

In general, if an I_IrmPolicyInfo Class method fails, the protector will not be able to recover from the error and will fail as well.

Remarks

This method enables the I_IrmProtector.HrProtect Method method of an autonomous Information Rights Management (IRM) protector to determine the URL of the document library in which the requested file is located. Users can navigate to the document library URL to request additional access to the document. It is a common practice to store the URL in the rights-managed document.

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

See Also

Reference

I_IrmProtector Interface

I_IrmPolicyInfo Class

Concepts

Information Rights Management in Windows SharePoint Services Overview

Custom IRM Protectors