IX509PrivateKey::Verify メソッド (certenroll.h)

  • [アーティクル]

Verify メソッドは、秘密キーが存在し、クライアントが使用できることを確認しますが、キーは開きません。

構文

HRESULT Verify(
  [in] X509PrivateKeyVerify VerifyType
);

パラメーター

[in] VerifyType

メソッドの実行オプションを指定する X509PrivateKeyVerify 列挙値。 これには、次のいずれかの値を指定できます。

値 意味
VerifyNone
 検証しません。
VerifySilent
 秘密キーを開くためにユーザー インターフェイスが必要かどうかを確認しません。それ以外の場合は検証が行われます。 詳細については、「解説」を参照してください。
VerifySmartCardNone
 キーがスマート カードに格納されているかどうかを確認しません。それ以外の場合、この値は VerifyAllowUI と同じです。
VerifySmartCardSilent
 秘密キーを開くためにユーザー インターフェイスが必要で、キーがスマート カードに格納されているかどうかを確認しません。それ以外の場合、この値は VerifyAllowUI と同じです。 詳細については、「解説」を参照してください。
VerifyAllowUI
 メソッドを使用すると、ユーザー インターフェイスを表示できます。

戻り値

関数が成功した場合、関数は S_OKを返します。

関数が失敗した場合は、エラーを示す HRESULT 値を返します。 有効な値を次の表に示しますが、これ以外にもあります。 また、このメソッドは CryptGetUserKey 関数と CryptAcquireContext CryptoAPI 関数を呼び出し、そのドキュメントで識別されたエラーを返すことができます。 一般的なエラー コードの一覧については、「 共通の HRESULT 値」を参照してください。

リターン コード 説明
CERTSRV_E_PROPERTY_EMPTY
 CSP または KSP に関連するプロパティが見つかりませんでした。

注釈

VerifySilent 値または VerifySmartCardSilent 値が設定され、暗号化プロバイダーがユーザー インターフェイスが必要であることを指定した場合、キーは開かなくなりますが、メソッドはS_OKを返します。

要件

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

こちらもご覧ください

IX509PrivateKey