BCryptDestroyKey 関数 (bcrypt.h)
BCryptDestroyKey 関数はキーを破棄します。
構文
NTSTATUS BCryptDestroyKey(
[in, out] BCRYPT_KEY_HANDLE hKey
);
パラメーター
[in, out] hKey
破棄するキーのハンドル。
戻り値
関数の成功または失敗を示す状態コードを返します。
可能な戻りコードには、以下が含まれますが、これらに限定されません。
| リターン コード | 形容 |
|---|---|
|
関数が成功しました。 |
|
hKey パラメーターのキー ハンドルが無効です。 |
備考
プロバイダーがサポートするプロセッサ モードに応じて、BCryptDestroyKey は、ユーザー モードまたはカーネル モードから呼び出すことができます。 カーネル モードの呼び出し元は、PASSIVE_LEVELIRQL または DISPATCH_LEVEL IRQL で実行できます。 現在の IRQL レベルが DISPATCH_LEVELされている場合、hKey パラメーターで指定されたハンドルは、BCRYPT_PROV_DISPATCH フラグで開かれたプロバイダーによって返されるアルゴリズム ハンドルから派生する必要があります。
カーネル モードでこの関数を呼び出すには、ドライバー開発キット (DDK) の一部である Cng.lib を使用します。 Windows Server 2008 および Windows Vista: カーネル モードでこの関数を呼び出すには、Ksecdd.lib を使用します。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista [デスクトップ アプリ |UWP アプリ] |
| サポートされる最小サーバー | Windows Server 2008 [デスクトップ アプリ |UWP アプリ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | bcrypt.h |
| ライブラリ | Bcrypt.lib |
| DLL | Bcrypt.dll |