IXpsSignature::Verify メソッド (xpsdigitalsignature.h)
指定した X.509 証明書に対して署名を検証します。
構文
HRESULT Verify(
[in] const CERT_CONTEXT *x509Certificate,
[out, retval] XPS_SIGNATURE_STATUS *sigStatus
);
パラメーター
[in] x509Certificate
検証に使用される X.509 証明書を含む CERT_CONTEXT 構造。
署名が不完全または非準拠の場合、この証明書は、XPS パッケージ内の署名されたデータがそのままであることを検証するためにのみ使用されます。 証明書は、他のチェックの実行には使用されません。 証明書を使用する前に、アプリケーションで信頼チェーンとその他の要件を確認する必要があります。
[out, retval] sigStatus
検証の結果を表す XPS_SIGNATURE_STATUS 値。
戻り値
このメソッドは HRESULT を返します。 使用可能な値には、次の表に示す値が含まれますが、これらに限定されません。 この表に記載されていない戻り値については、「 XPS デジタル署名 API エラー と XPS ドキュメント エラー」を参照してください。
| リターン コード | 説明 |
|---|---|
|
メソッドが成功しました。 |
|
x509Certificate または sigStatus が NULL です。 |
|
インターフェイスが署名マネージャーに接続されていません。 |
注釈
このメソッドは、 XML Paper Specification のセクション 10.2.1.2 で指定された順序で署名の状態を検出します。 検出のシーケンスは、非準拠、不完全、破損、疑わしい、最後に有効です。 つまり、たとえば、署名が非準拠であることが判明した場合、署名も破損している場合、ダイジェストは計算されません。
このメソッドで検出できるさまざまな種類の署名状態の詳細については、「 XPS_SIGNATURE_STATUS」を参照してください。
要件
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | xpsdigitalsignature.h |