NCryptQueryProtectionDescriptorName 函式 (ncryptprotect.h)

  • 發行項

NCryptQueryProtectionDescriptorName 函式會擷取與已註冊描述項顯示名稱相關聯的保護描述項規則字元串。

語法

SECURITY_STATUS NCryptQueryProtectionDescriptorName(
  [in]      LPCWSTR pwszName,
  [out]     LPWSTR  pwszDescriptorString,
  [in, out] SIZE_T  *pcDescriptorString,
            DWORD   dwFlags
);

參數

[in] pwszName

保護描述元的已註冊顯示名稱。 呼叫 NCryptRegisterProtectionDescriptorName 函式來註冊名稱。

[out] pwszDescriptorString

以 Null 終止的 Unicode 字串，其中包含保護描述項規則。 將此值設定為 NULL ，並在初始呼叫此函式時，將 pcDescriptorString 自變數所指向的描述元字串大小設定為零。 如需詳細資訊，請參閱＜備註＞。

[in, out] pcDescriptorString

變數的指標，其中包含 pwszDescriptorString 參數中所擷取字串中的字元數。 在對這個函式的初始呼叫上，將變數設定為零。 如需詳細資訊，請參閱＜備註＞。

dwFlags

旗標，指定要查詢已註冊名稱的登錄區。 這可以是零來查看 HKEY_CURRENT_USER 登錄區，或者您可以指定 NCRYPT_MACHINE_KEY_FLAG 來查詢 HKEY_LOCAL_MACHINE Hive。

傳回值

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

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

備註

若要擷取保護描述項規則字串，您必須呼叫此函式兩次。 第一次呼叫時，請將 pwszDescriptorString 自變數設定為 NULL ，並將 pcDescriptorString 自變數所指向的值設定為零。 您的第一次呼叫會擷取描述元字串中的字元數。 使用此數位來配置字串的記憶體，並擷取已配置緩衝區的指標。 若要擷取字串，請使用指標再次呼叫 函式。

規格需求

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

另請參閱

CNG DPAPI 函式

NCryptRegisterProtectionDescriptorName