共用方式為

BCryptSetContextFunctionProperty 函式 (bcrypt.h)

  • 發行項

BCryptSetContextFunctionProperty 函式會為現有 CNG 內容中的密碼編譯函式設定具名屬性的值。

語法

NTSTATUS BCryptSetContextFunctionProperty(
  [in] ULONG   dwTable,
  [in] LPCWSTR pszContext,
  [in] ULONG   dwInterface,
  [in] LPCWSTR pszFunction,
  [in] LPCWSTR pszProperty,
  [in] ULONG   cbValue,
  [in] PUCHAR  pbValue
);

參數

[in] dwTable

識別內容存在於中的組態數據表。 這可以是下列其中一個值。

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

[in] pszContext

Null 終止 Unicode 字串的指標，其中包含要設定函式屬性的內容識別碼。

[in] dwInterface

識別函式存在於的密碼編譯介面。 這可以是下列其中一個值。

值 意義
BCRYPT_ASYMMETRIC_ENCRYPTION_INTERFACE
 函式存在於非對稱加密函式清單中。
BCRYPT_CIPHER_INTERFACE
 函式存在於加密函式清單中。
BCRYPT_HASH_INTERFACE
 函式存在於哈希函式清單中。
BCRYPT_RNG_INTERFACE
 函式存在於隨機數產生器函式清單中。
BCRYPT_SECRET_AGREEMENT_INTERFACE
 函式存在於秘密合約函式清單中。
BCRYPT_SIGNATURE_INTERFACE
 函式存在於簽章函式清單中。
NCRYPT_KEY_STORAGE_INTERFACE
 函式存在於金鑰記憶體函式清單中。
NCRYPT_SCHANNEL_INTERFACE
 函式存在於安全通道函式清單中。

[in] pszFunction

Null 終止 Unicode 字串的指標，其中包含要為其設定屬性的密碼編譯函式標識符。

[in] pszProperty

Null 終止 Unicode 字串的指標，其中包含要設定之屬性的標識碼。

[in] cbValue

包含 pbValue 緩衝區的大小，以位元組為單位。 這是將儲存的確切位元組數目。 如果屬性值是字串，您應該視需要新增一個字元的大小，以同時儲存終止的 Null 字元。

[in] pbValue

包含新屬性值的緩衝區位址。

傳回值

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

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

傳回碼 Description
STATUS_SUCCESS
 函式成功。
STATUS_ACCESS_DENIED
 呼叫端沒有函式屬性的寫入許可權。
STATUS_INVALID_PARAMETER
 一或多個參數無效。
STATUS_NO_MEMORY
 發生記憶體配置失敗。
STATUS_NOT_FOUND
 找不到指定的內容或函式。

備註

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

規格需求

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