PvkPrivateKeyAcquireContextFromMemory 関数

重要

この API は非推奨です。 Microsoft は、今後のリリースでこの API を削除する可能性があります。

 

PvkPrivateKeyAcquireContextFromMemory 関数は、暗号化サービス プロバイダー (CSP) に一時コンテナーを作成し、メモリからコンテナーに秘密キーを読み込みます。

Note

この関数には、ヘッダー ファイルまたはインポート ライブラリが関連付けされません。 この関数を呼び出すには、ユーザー定義ヘッダー ファイルを作成し、 LoadLibrary 関数と GetProcAddress 関数を使用して、Mssign32.dllに動的にリンクする必要があります。

 

構文

BOOL WINAPI PvkPrivateKeyAcquireContextFromMemory(
  _In_        LPCWSTR    pwszProvName,
  _In_        DWORD      dwProvType,
  _In_        BYTE       *pbData,
  _In_        DWORD      cbData,
  _In_        HWND       hwndOwner,
  _In_        LPCWSTR    pwszKeyName,
  _Inout_opt_ DWORD      *pdwKeySpec,
  _Out_       HCRYPTPROV *phCryptProv,
  _Out_       LPTSTR     *ppwszTmpContainer
);

パラメーター

pwszProvName [in]

dwProvType で型が要求された CSP の名前を含む null で終わる文字列へのポインター。

dwProvType [in]

CSP 型の DWORD 値。 CSP の種類の詳細については、「 暗号化プロバイダーの種類」を参照してください。

pbData [in]

コンテキスト データを受け取るバッファーへのポインター。 呼び出し元は、このリソースを提供する必要があります。

cbData [in]

pbData バッファーのサイズをバイト単位で指定する DWORD 値。 呼び出し元は、この値を指定する必要があります。

hwndOwner [in]

pbData パラメーターが指すコンテキスト データの暗号化を解除するためにパスワードが必要な場合、このパラメーターはダイアログ ボックスの親へのハンドルです。それ以外の場合は NULL です。

pwszKeyName [in]

取得するキーの名前を含む null で終わる文字列へのポインター。

pdwKeySpec [in, out, optional]

キーの種類を指定する DWORD 値へのポインター。 使用可能な値には 、AT_KEYEXCHANGE または AT_SIGNATUREが含まれます。

phCryptProv [out]

CSP のハンドルへのポインター。

ppwszTmpContainer [out]

一時コンテナー名の null で終わる文字列へのポインターのアドレス。 PvkPrivateKeyAcquireContextFromMemory 関数は、この文字列のバッファーを提供し、初期化します。 PvkPrivateKeyAcquireContextFromMemory を呼び出す場合、アドレスは NULL 値を指す必要があります。

戻り値

成功すると、この関数は TRUE を返します。 PvkPrivateKeyAcquireContextFromMemory 関数は、失敗した場合は FALSE を返します。

要件

要件	値
サポートされている最小のクライアント	Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ]
[DLL]	Mssign32.dll