通过

如何：注册 IRM 保护程序

  • 项目

上次修改时间： 2010年4月4日

适用范围： SharePoint Foundation 2010

在编译自定义信息权限管理 (IRM) 保护程序后，您必须向 Microsoft SharePoint Foundation 2010 注册该保护程序，以使其可用于文档库。

需在场级注册每个 IRM 保护程序并使其可用于服务器场中的每个文档库。必须在每个前端 Web 服务器上注册和部署每个 IRM 保护程序，且必须将其添加到每个前端 Web 服务器的每个注册表子树中。

向 SharePoint Foundation 注册 IRM 保护程序

  1. 将该保护程序注册为 COM 对象。

    应将此对象的线程模型设置为 both。将该保护程序注册为 COM 对象将允许 SharePoint Foundation 2010 引用该保护程序的功能。

  2. 创建以下注册表项：

    HKLM\SOFTWARE\Microsoft\Shared Tools\Web Server Extensions\<protector name>

  3. 在 HKLM\ SOFTWARE\Microsoft\Shared Tools\Web Server Extensions\12.0\IrmProtectors 项中设置以下注册表子项：

    • **名称：**保护程序的 ClassID。必须为用于将该保护程序注册为 COM 对象的 ClassID。

    • **值：**保护程序的名称。

    • **类型：**字符串

    此外，我们还强烈建议保护程序将有关其自身的某些元数据存储到注册表中。具体来说，我们建议（但不要求）保护程序设置和使用在 HKLM\SOFTWARE\Microsoft\Shared Tools\Web Server Extensions\<protector name> 项中设置的以下注册表子项：

    • **名称：**扩展名

    • **值：**该保护程序转换的以逗号分隔的文件扩展名列表。

    • **类型：**字符串

    • **名称：**产品

    • **值：**保护程序的名称。

    • **类型：**字符串

    • **名称：**版本

    • **值：**保护程序的版本号。

    • **类型：**字符串

示例

下面的示例是一个 .wxs 文件，该文件演示如何将文件格式与 IRM 保护程序相关联。此示例将 IRM 保护程序注册为 COM 对象，并设置正确的注册表项。

<?xml version="1.0" encoding="UTF-8"?>
<Wix xmlns="https://schemas.microsoft.com/wix/2003/01/wi">
  <Fragment>
    <DirectoryRef Id="STSBin">
      <Component Id="Contoso_IrmProtector" DiskId="1">
        <File Id="CONIRMP.DLL_0001">
          <TypeLib Id="C0321D28-5B26-4CE5-855C-7863852283C6" 
            Advertise="no" Language="0" MajorVersion="1">
            <Class Id="4F9976DC-47C3-4518-B2A2-A258B379F970" 
              Description="IrmProtector Class" ThreadingModel="both" 
              Context="InprocServer InprocServer32">
              <ProgId Id="IrmProtector.Protector.1">
                <ProgId Id="IrmProtector.Protector" />
              </ProgId>
            </Class>
          </TypeLib>
        </File>

<Registry Id="IrmProtector.1" Root="HKLM" Key="SOFTWARE\Microsoft\Shared Tools\Web Server 
Extensions\12.0\IrmProtectors" Name="{4F9976DC-47C3-4518-B2A2-A258B379F970}" 
Value="Contoso.Irm.Protector" Type="string" />

<Registry Id="IrmProtector.2" Root="HKLM" Key="SOFTWARE\Microsoft\Shared Tools\Web Server 
Extensions\IrmProtector" Action="createKeyAndRemoveKeyOnUninstall" />

<Registry Id="IrmProtector.3" Root="HKLM" Key="SOFTWARE\Microsoft\Shared Tools\Web Server 
Extensions\IrmProtector" Name="Extensions" Value="XYZ,PDQ,FOO"  Type="string" />

<Registry Id="MsoProtector.4" Root="HKLM" Key="SOFTWARE\Microsoft\Shared Tools\Web Server 
Extensions\IrmProtector" Name="Product" Value="MsoProtector" Type="string" />

<Registry Id="IrmProtector.5" Root="HKLM" Key="SOFTWARE\Microsoft\Shared Tools\Web Server 
Extensions\IrmProtector" Name="Version" Value="1" Type="string" />

      </Component>
    </DirectoryRef>
  </Fragment>
</Wix>

请参阅

概念

SharePoint Foundation 中的信息权限管理

SharePoint Foundation 中的 IRM 框架体系结构

IRM 文件处理

自定义 IRM 保护程序