IXpsSignatureManager::AddSignatureBlock メソッド (xpsdigitalsignature.h)

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

新しい IXpsSignatureBlock インターフェイスを作成し、それをシグネチャブロックコレクションに追加します。

構文

HRESULT AddSignatureBlock(
  [in]          IOpcPartUri        *partName,
  [in]          UINT32             fixedDocumentIndex,
  [out, retval] IXpsSignatureBlock **signatureBlock
);

パラメーター

[in] partName

新しいパーツの URI を含む IOpcPartUri インターフェイスへのポインター。メソッドでパーツ名を生成するには、このパラメーターを NULL に設定できます。

[in] fixedDocumentIndex

新しい署名ブロックを関連付ける FixedDocument パーツのインデックス値。

[out, retval] signatureBlock

新しい IXpsSignatureBlock インターフェイスへのポインター。新しいインターフェイスへのアクセスが必要ない場合は、このパラメーターを NULL に設定できます。

戻り値

このメソッドは HRESULT を返します。使用可能な値には、次の表に含まれる値が含まれますが、これらに限定されません。この表に記載されていない戻り値については、「 XPS デジタル署名 API エラーと XPS ドキュメントエラー」を参照してください。

リターンコード	説明
S_OK	メソッドが成功しました。
E_INVALIDARG	fixedDocumentIndex は、XPS パッケージに見つからない固定ドキュメントを参照します。
XPS_E_PACKAGE_NOT_OPENED	署名マネージャーで XPS パッケージがまだ開かれていない。

注釈

署名ブロックは、XPS パッケージ内の SignatureDefinitions パーツを表します。 XML Paper Specification のセクション 10.2.2 によると、0 個以上の SignatureDefinitions パーツを各 FixedDocument にアタッチできます。このメソッドは、指定した名前を持つ新しい SignatureDefinitions パーツを作成し、指定された FixedDocument パーツからリレーションシップによってリンクし、新しい IXpsSignatureBlock インターフェイスを作成して、この新しいインターフェイスを内部署名ブロックコレクションに追加します。

シグネチャブロックを取得するには、 GetSignatureBlocks メソッドを呼び出します。

要件

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