SslOpenPrivateKey 関数

  • [アーティクル]

SslOpenPrivateKey 関数は、秘密キーへのハンドルを開きます。

構文

SECURITY_STATUS WINAPI SslOpenPrivateKey(
  _In_  NCRYPT_PROV_HANDLE hSslProvider,
  _Out_ NCRYPT_KEY_HANDLE  *phPrivateKey,
  _In_  PCCERT_CONTEXT     pCertContext,
  _In_  DWORD              dwFlags
);

パラメーター

hSslProvider [in]

Secure Sockets Layer プロトコル (SSL) プロトコル プロバイダー インスタンスへのハンドル。

phPrivateKey [out]

秘密キーにハンドルを書き込むバッファーのアドレス。

キーの使用が完了したら、SslFreeObject 関数を呼び出して phPrivateKey を解放する必要があります。

pCertContext [in]

秘密キーの取得元となる証明書のアドレス。

dwFlags [in]

このパラメーターは将来使用するために予約されています。

戻り値

関数が成功すると、0 が返されます。

関数が失敗すると、0 以外のエラー値が返されます。

可能な戻りコードには、次のものが含まれますが、これらに限定されません。

リターン コード/値 説明
NTE_NO_MEMORY
0x8009000EL
 必要なバッファーを割り当てるのに十分なメモリがありません。
NTE_INVALID_HANDLE
0x80090026L
 hSslProvider ハンドルが無効です。
NTE_INVALID_PARAMETER
0x80090027L
 phPrivateKey または pCertContext パラメーターが NULL です。

注釈

取得された秘密キーは、証明書内の公開キーと秘密キーのペアの一部です。 この関数は、 pCertContext パラメーターで指定された証明書から秘密キーを抽出するだけです。

要件

要件 値
サポートされている最小のクライアント
 Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2008 [デスクトップ アプリのみ]
Header
Sslprovider.h
[DLL]
Ncrypt.dll