NCryptDeleteKey 関数 (ncrypt.h)

NCryptDeleteKey 関数は CNG キーを削除します。

構文

SECURITY_STATUS NCryptDeleteKey(
  [in] NCRYPT_KEY_HANDLE hKey,
  [in] DWORD             dwFlags
);

[in] hKey

削除するキーのハンドル。このハンドルは、 NCryptOpenKey 関数を使用して取得されます。

メモNCryptDeleteKey 関数はキーを削除し、ハンドルを解放します。 NCryptDeleteKey が失敗した場合、アプリケーションは NCryptFreeObject 関数を使用してハンドルを解放できます。

[in] dwFlags

関数の動作を変更するフラグ。これには、0 または各キーストレージプロバイダーに固有の値の組み合わせを指定できます。

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

関数の成功または失敗を示す状態コードを返します。

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

リターンコード	説明
ERROR_SUCCESS	関数は成功しました。
NTE_BAD_FLAGS	dwFlags パラメーターに無効な値が含まれています。
NTE_INVALID_HANDLE	hKey パラメーターが無効です。

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


サポートされている最小のクライアント	Windows Vista [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	ncrypt.h
Library	Ncrypt.lib
[DLL]	Ncrypt.dll