NCryptDeleteKey 関数は CNG キーを削除します。
構文
SECURITY_STATUS NCryptDeleteKey(
[in] NCRYPT_KEY_HANDLE hKey,
[in] DWORD dwFlags
);
パラメーター
[in] hKey
削除するキーのハンドル。 このハンドルは、 NCryptOpenKey 関数を使用して取得されます。
メモNCryptDeleteKey 関数はキーを削除し、ハンドルを解放します。
NCryptDeleteKey が失敗した場合、アプリケーションは NCryptFreeObject 関数を使用してハンドルを解放できます。
[in] dwFlags
関数の動作を変更するフラグ。 これには、0 または各キー ストレージ プロバイダーに固有の値の組み合わせを指定できます。
| 値 | 意味 |
|---|---|
|
キー サービス プロバイダー (KSP) にユーザー インターフェイスが表示されないことを要求します。 プロバイダーが操作する UI を表示する必要がある場合、呼び出しは失敗し、KSP は NTE_SILENT_CONTEXT エラー コードを最後のエラーとして設定する必要があります。 |
戻り値
関数の成功または失敗を示す状態コードを返します。
可能なリターン コードには、次のものが含まれますが、これらに限定されません。
| リターン コード | 説明 |
|---|---|
|
関数は成功しました。 |
|
dwFlags パラメーターに無効な値が含まれています。 |
|
hKey パラメーターが無効です。 |
注釈
サービスは 、StartService 関数からこの関数を呼び出してはなりません。 サービスが StartService 関数からこの関数を呼び出すと、デッドロックが発生し、サービスが応答を停止する可能性があります。
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリ |UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | ncrypt.h |
| Library | Ncrypt.lib |
| [DLL] | Ncrypt.dll |