IOpcDigitalSignature::GetSignatureMethod メソッド (msopc.h)

[アーティクル]
02/29/2024

シグネチャマークアップの SignatureValue 要素の値を計算するために使用されるシグネチャメソッドを取得します。

構文

HRESULT GetSignatureMethod(
  [out, retval] LPWSTR *signatureMethod
);

パラメーター

[out, retval] signatureMethod

シグネチャメソッドへのポインター。

戻り値

このメソッドは HRESULT を返します。有効な値を次の表に示しますが、これ以外にもあります。

リターンコード	説明
S_OK	メソッドが成功しました。
E_POINTER	signatureMethod パラメーターが NULL です。

注釈

このメソッドは、 signatureMethod で返される文字列によって使用されるメモリを割り当てます。メソッドが成功した場合は、 CoTaskMemFree 関数を呼び出してメモリを解放します。

シグネチャが生成される前にシグネチャメソッドを設定するには、 IOpcSigningOptions::SetSignatureMethod メソッドを呼び出します。

署名が生成される前にシグネチャメソッドにアクセスするには、 IOpcSigningOptions::GetSignatureMethod を呼び出します。署名の生成後にシグネチャメソッドにアクセスするには、 IOpcDigitalSignature::GetSignatureMethod メソッドを呼び出します。どちらのメソッドも、 IOpcSigningOptions::SetSignatureMethod によって設定された値を取得します。

大事なIOpcDigitalSignatureManager::Sign メソッドを呼び出して署名を生成する前に、有効なシグネチャメソッドを設定する必要があります。

署名が生成されると、署名マークアップとしてシリアル化されます。シグネチャメソッドは、シグネチャマークアップの SignatureValue 要素の値を計算するために使用されます。

シグネチャが検証されると、シグネチャメソッドを使用してその値が再計算され、再計算された値がシグネチャマークアップの SignatureValue 要素の値と比較されます。

スレッドセーフ

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

詳細については、Packaging API を使用したはじめにに関するページを参照してください。

要件

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