IOpcDigitalSignatureManager インターフェイス (msopc.h)

[アーティクル]
03/13/2024

Packaging API オブジェクトで表されるパッケージに対する Packaging Digital Signature Interfaces へのアクセスを提供します。これらのインターフェイスメソッドは、署名を生成したり、パッケージ内の既存の署名にアクセスして検証したりするために呼び出されます。

継承

IOpcDigitalSignatureManager インターフェイスは、IUnknown インターフェイスから継承します。 IOpcDigitalSignatureManager には、次の種類のメンバーもあります。

メソッド

IOpcDigitalSignatureManager インターフェイスには、これらのメソッドがあります。


IOpcDigitalSignatureManager::CreateSigningOptions IOpcSigningOptions インターフェイスポインターを作成します。
IOpcDigitalSignatureManager::GetSignatureEnumerator パッケージ署名を表す IOpcDigitalSignature インターフェイスポインターの列挙子を取得します。
IOpcDigitalSignatureManager::GetSignatureOriginPartName Digital Signature Origin パーツのパーツ名を表す IOpcPartUri インターフェイスポインターを取得します。
IOpcDigitalSignatureManager::RemoveSignature 署名マークアップを格納する指定した署名パーツをパッケージから削除します。
IOpcDigitalSignatureManager::ReplaceSignatureXml 指定した署名パーツに格納されている既存の署名マークアップを置き換えます。
IOpcDigitalSignatureManager::SetSignatureOriginPartName Digital Signature Origin パーツのパーツ名を、指定した IOpcPartUri インターフェイスポインターで表される名前に設定します。
IOpcDigitalSignatureManager::Sign 指定した証明書と IOpcSigningOptions インターフェイスポインターを使用して署名を生成して、パッケージに署名します。
IOpcDigitalSignatureManager::Validate 指定した証明書を使用して、指定したパッケージ署名を検証します。

注釈

署名を生成するために Sign メソッドを呼び出す前に、 IOpcSigningOptions::SetDefaultDigestMethod メソッドと IOpcSigningOptions::SetSignatureMethod メソッドを呼び出す必要があります。

IOpcDigitalSignatureManager インターフェイスポインターを作成するには、IOpcFactory::CreateDigitalSignatureManager メソッドを呼び出します。

大事なSign メソッドの実行中にパッケージが変更された場合、メソッドが失敗したり、一貫性のない署名が生成されたりする可能性があります。パッケージの破損を回避するには、Sign を呼び出す前に API を使用してパッケージを保存 します。パッケージを保存する方法の詳細については、「パッケージの保存」を参照してください。

Validate メソッドは、署名が生成されてから指定された署名 (署名付きエンティティと署名マークアップ) が変更されていないことを確認しますが、署名者の ID は検証しません。

大事な 呼び出し元は署名者の ID を検証する必要があります。

スレッドセーフ

パッケージ化オブジェクトはスレッドセーフではありません。

IOpcSigningOptions 詳細については、「Packaging API を使用したはじめに」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	msopc.h