ホーム › Security.Cryptography › NCryptSecretAgreementFn

NCryptSecretAgreementFn

コールバック

シグネチャ

HRESULT NCryptSecretAgreementFn(
    NCRYPT_PROV_HANDLE hProvider,
    NCRYPT_KEY_HANDLE hPrivKey,
    NCRYPT_KEY_HANDLE hPubKey,
    NCRYPT_SECRET_HANDLE* phAgreedSecret,
    DWORD dwFlags
);

パラメーター

フィールド

型

説明

hProvider

NCRYPT_PROV_HANDLE

hPrivKey

NCRYPT_KEY_HANDLE

シークレットアグリーメント値の作成に使用する秘密鍵のハンドルです。このキーと hPubKey のキーは、同じキーストレージプロバイダーのものである必要があります。

hPubKey

NCRYPT_KEY_HANDLE

シークレットアグリーメント値の作成に使用する公開鍵のハンドルです。このキーと hPrivKey のキーは、同じキーストレージプロバイダーのものである必要があります。

phAgreedSecret

NCRYPT_SECRET_HANDLE*

シークレットアグリーメント値を表すハンドルを受け取る NCRYPT_SECRET_HANDLE 変数へのポインターです。このハンドルが不要になったら、NCryptFreeObject 関数に渡して解放してください。

dwFlags

DWORD

関数の動作を変更するフラグです。0、または次の値の 1 つ以上の組み合わせを指定できます。有効なフラグの組み合わせは、キーストレージプロバイダーごとに異なります。次のフラグはすべてのプロバイダーに適用されます。

値	意味
NCRYPT_SILENT_FLAG	キーストレージプロバイダー (KSP) がユーザーインターフェイスを表示しないよう要求します。プロバイダーが動作するために UI を表示する必要がある場合、呼び出しは失敗し、KSP は最後のエラーとして NTE_SILENT_CONTEXT エラーコードを設定します。

公式ドキュメント

NCryptSecretAgreement 関数は、秘密鍵と公開鍵からシークレットアグリーメント値を作成します。

戻り値

関数の成功または失敗を示すステータスコードを返します。

戻り値には、次のものが含まれますが、これらに限定されません。

戻り値	説明
ERROR_SUCCESS	関数は成功しました。
NTE_INVALID_HANDLE	hPrivKey または hPubKey パラメーターが無効です。
NTE_INVALID_PARAMETER	1 つ以上のパラメーターが無効です。
NTE_NO_MEMORY	メモリの割り当てに失敗しました。

解説(Remarks)

サービスは、StartService 関数からこの関数を呼び出してはいけません。サービスが StartService 関数からこの関数を呼び出すと、デッドロックが発生し、サービスが応答しなくなる可能性があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)