IXpsSignatureBlock::CreateRequest メソッド (xpsdigitalsignature.h)

[アーティクル]
12/22/2023

新しい IXpsSignatureRequest インターフェイスを作成し、署名ブロックに追加します。

構文

HRESULT CreateRequest(
  [in]          LPCWSTR              requestId,
  [out, retval] IXpsSignatureRequest **signatureRequest
);

パラメーター

[in] requestId

署名ブロック内の新しい署名要求を一意に識別する文字列。メソッドで ID 文字列を生成するには、このパラメーターを NULL に設定 します。

[out, retval] signatureRequest

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

戻り値

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

リターンコード	説明
S_OK	メソッドが成功しました。
E_UNEXPECTED	インターフェイスが署名マネージャーに接続されていないか、 requestId が NULL で、一意の ID 文字列を生成できませんでした。

注釈

新しい署名要求には一意の要求 ID が必要です。同じ ID 文字列を持つ 2 つの要求はありません。

新しい要求を作成すると、署名ブロックがダーティとしてマークされ、SignatureDefinitions パーツの新しいコンテンツが生成されます。 XPS パッケージをシリアル化すると、新しいコンテンツによって SignatureDefinitions パーツ内の以前のコンテンツが上書きされます。

要件


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