Share via

BCryptCreateContext 函式 (bcrypt.h)

  • 發行項

[BCryptCreateContext 可用於需求一節中指定的操作系統。 後續版本可能會變更或無法使用。]

BCryptCreateContext 函式會建立新的 CNG 設定內容。

語法

NTSTATUS BCryptCreateContext(
  [in]           ULONG                 dwTable,
  [in]           LPCWSTR               pszContext,
  [in, optional] PCRYPT_CONTEXT_CONFIG pConfig
);

參數

[in] dwTable

識別要建立內容的組態數據表。 這可以是下列其中一個值。

值 意義
CRYPT_LOCAL
 在本機計算機組態數據表中建立內容。
CRYPT_DOMAIN
 這個值無法使用。

[in] pszContext

Null 終止 Unicode 字串的指標，其中包含要建立之內容的標識碼。

[in, optional] pConfig

CRYPT_CONTEXT_CONFIG 結構的指標，其中包含新內容的其他組態數據。 如果不需要此參數，這個參數可以是 NULL 。

傳回值

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

可能的傳回碼包括但不限於下列專案。

傳回碼 Description
STATUS_SUCCESS
 函式成功。
STATUS_INVALID_PARAMETER
 一或多個參數無效。
STATUS_NO_MEMORY
 發生記憶體配置失敗。

備註

BCryptCreateContext 只能在使用者模式中呼叫。

規格需求

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