NCryptDeleteKey 函式 (ncrypt.h)
NCryptDeleteKey 函式會刪除 CNG 金鑰。
語法
SECURITY_STATUS NCryptDeleteKey(
[in] NCRYPT_KEY_HANDLE hKey,
[in] DWORD dwFlags
);
參數
[in] hKey
要刪除之索引鍵的控制碼。 此控制碼是使用 NCryptOpenKey 函式取得。
注意NCryptDeleteKey 函式會刪除金鑰並釋放控制碼。 如果NCryptDeleteKey失敗,應用程式可能會使用NCryptFreeObject函式釋放控制碼。
[in] dwFlags
修改函式行為的旗標。 這可以是零或每個金鑰儲存提供者特有的值組合。
值 | 意義 |
---|---|
|
要求金鑰服務提供者 (KSP) 不會顯示任何使用者介面。 如果提供者必須顯示要運作的 UI,呼叫會失敗,KSP 應該將 NTE_SILENT_CONTEXT 錯誤碼設定為最後一個錯誤。 |
傳回值
傳回狀態碼,指出函式的成功或失敗。
可能的傳回碼包括但不限於下列專案。
傳回碼 | Description |
---|---|
|
函式成功。 |
|
dwFlags參數包含不正確值。 |
|
hKey參數無效。 |
備註
服務不得從它的 StartService 函式呼叫此函式。 如果服務從其 StartService 函式呼叫此函式,可能會發生死結,而且服務可能會停止回應。
規格需求
最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | ncrypt.h |
程式庫 | Ncrypt.lib |
Dll | Ncrypt.dll |