iXpsSignatureManager 接口 (xpsdigitalsignature.h)

管理 XPS 文档的数字签名和数字签名请求。

继承

IXpsSignatureManager 接口继承自 IUnknown 接口。 IXpsSignatureManager 还具有以下类型的成员：

方法

IXpsSignatureManager 接口包含以下方法。

IXpsSignatureManager：：AddSignatureBlock 创建新的 IXpsSignatureBlock 接口，并将其添加到签名块集合。
IXpsSignatureManager：：CreateSigningOptions 创建新的 IXpsSigningOptions 接口。
IXpsSignatureManager：：GetSignatureBlocks 获取指向包含签名块集合的 IXpsSignatureBlockCollection 接口的指针。
IXpsSignatureManager：：GetSignatureOriginPartName 获取签名源部件的部件名称。
IXpsSignatureManager：：GetSignatures 获取指向包含 XPS 数字签名集合的 IXpsSignatureCollection 接口的指针。
IXpsSignatureManager：：LoadPackageFile 将现有 XPS 包从文件加载到数字签名管理器中。
IXpsSignatureManager：：LoadPackageStream 将 XPS 包从流加载到数字签名管理器中。
IXpsSignatureManager：：SavePackageToFile 将 XPS 包保存到文件中。
IXpsSignatureManager：：SavePackageToStream 通过将 XPS 包写入流来保存它。
IXpsSignatureManager：：SetSignatureOriginPartName 设置签名源部件的部件名称。
IXpsSignatureManager：：Sign 根据签名选项指定对 XPS 包的内容进行签名，并返回生成的数字签名。

注解

若要初始化签名管理器以用于 XPS 文档，请通过调用 CoCreateInstance 实例化 IXpsSignatureManager 接口，如以下示例所示。

IXpsSignatureManager    *newInterface;

// Note the implicit requirement that CoInitializeEx
//  has previously been called from this thread.

hr = CoCreateInstance(
    __uuidof(XpsSignatureManager),
    NULL, 
    CLSCTX_INPROC_SERVER,
    __uuidof(IXpsSignatureManager),
    reinterpret_cast<LPVOID*>(&newInterface));

// make sure that you got a pointer
// to the interface
if (SUCCEEDED(hr)) {
    // Load document into signature manager from file.
    //  xpsDocument is initialized with the file name
    //  of the document to load outside of this example.
    hr = newInterface->LoadPackageFile (xpsDocument);

    // Use newInterface

    // Release interface pointers when finished with them
    newInterface->Release();
}

CoCreateInstance 实例化的接口只能由一个 XPS 文档使用，在调用任何其他方法之前，必须通过调用 LoadPackageFile 或 LoadPackageStream 来加载该文档。

实例化 IXpsSignatureManager 接口并加载 XPS 文档后，签名管理器可供使用。

要求

最低受支持的客户端	Windows 7 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 R2 [仅限桌面应用]
目标平台	Windows
标头	xpsdigitalsignature.h

另请参阅

CoCreateInstance

接口

XML 纸张规范