共用方式為

NCryptOpenStorageProvider 函式 (ncrypt.h)

  • 發行項

NCryptOpenStorageProvider 函式會載入並初始化 CNG 金鑰儲存提供者。

語法

SECURITY_STATUS NCryptOpenStorageProvider(
  [out]          NCRYPT_PROV_HANDLE *phProvider,
  [in, optional] LPCWSTR            pszProviderName,
  [in]           DWORD              dwFlags
);

參數

[out] phProvider

接收提供者句柄 之NCRYPT_PROV_HANDLE 變數的指標。 當您完成使用此句柄時，請將它傳遞至 NCryptFreeObject 函式來釋放它。

[in, optional] pszProviderName

Null 終止 Unicode 字串的指標，可識別要載入的密鑰儲存提供者。 這是金鑰儲存提供者的已註冊別名。 此參數是選擇性的，可以是 NULL。 如果此參數為 NULL，則會載入預設金鑰儲存提供者。 下列值會識別內建金鑰儲存提供者。

值 意義
MS_KEY_STORAGE_PROVIDER
L“Microsoft 軟體密鑰儲存提供者”
 識別 Microsoft 提供的軟體金鑰儲存提供者。
MS_SMART_CARD_KEY_STORAGE_PROVIDER
L“Microsoft 智慧卡密鑰儲存提供者”
 識別 Microsoft 提供的智慧卡金鑰儲存提供者。
MS_PLATFORM_CRYPTO_PROVIDER
L“Microsoft Platform Crypto Provider”
 識別 Microsoft 提供的 TPM 金鑰儲存提供者。

[in] dwFlags

修改函式行為的旗標。 此函式未定義旗標。

傳回值

傳回狀態代碼，指出函式的成功或失敗。

可能的傳回碼包括但不限於下列各項。

傳回碼 Description
ERROR_SUCCESS
 函式成功。
NTE_BAD_FLAGS
 dwFlags 參數包含一或多個不支援的旗標。
NTE_INVALID_PARAMETER
 一或多個參數無效。
NTE_NO_MEMORY
 發生記憶體配置失敗。

備註

如果傳回錯誤狀況，提供者將會從記憶體卸除。 傳回失敗錯誤之後，不得呼叫提供者內的函式。

服務不得從它的 StartService 函式呼叫此函式。 如果服務從它的 StartService 函式呼叫此函式，可能會發生死結，而且服務可能會停止回應。

規格需求

需求 值
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 ncrypt.h
程式庫 Ncrypt.lib
Dll Ncrypt.dll