共用方式為

NCryptRegisterProtectionDescriptorName 函式 (ncryptprotect.h)

  • 發行項

NCryptRegisterProtectionDescriptorName 函式會註冊保護描述元的顯示名稱和相關聯的規則字串。

語法

SECURITY_STATUS NCryptRegisterProtectionDescriptorName(
  [in]           LPCWSTR pwszName,
  [in, optional] LPCWSTR pwszDescriptorString,
                 DWORD   dwFlags
);

參數

[in] pwszName

Null 終止的 Unicode 字串指標，其中包含要註冊之描述元的顯示名稱。

[in, optional] pwszDescriptorString

包含保護描述元規則之 Null 終止 Unicode 字串的指標。 如果此參數為 NULL 或字串是空的，則會刪除先前為 pwszName 參數建立的登錄值。

dwFlags

常數，表示要在其中註冊新專案的登錄區。 如果此值為零 (0) ，則登錄根目錄 會HKEY_CURRENT_USER。 如果此值 NCRYPT_MACHINE_KEY_FLAG，則根目錄 會HKEY_LOCAL_MACHINE。

傳回值

傳回狀態代碼，指出函式的成功或失敗。 可能的傳回碼包括但不限於下列專案。

傳回碼 Description
ERROR_SUCCESS
 函式成功。
NTE_INVALID_PARAMETER
 pwszName 參數不可以是 NULL，而 參數所指向的值不能是空字串。
NTE_BAD_FLAGS
 dwFlags 參數必須是零或NCRYPT_MACHINE_KEY_FLAG。

備註

使用此函式建立的登錄機碼不是變動性。 此資訊會儲存在檔案中，並在電腦關閉時保留。

規格需求

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

另請參閱

CNG DPAPI 函式

NCryptQueryProtectionDescriptorName