共用方式為

NCryptGetProtectionDescriptorInfo 函式 (ncryptprotect.h)

  • 發行項

NCryptGetProtectionDescriptorInfo 函式會擷取保護描述項規則字串。

語法

SECURITY_STATUS NCryptGetProtectionDescriptorInfo(
  [in]           NCRYPT_DESCRIPTOR_HANDLE hDescriptor,
  [in, optional] const NCRYPT_ALLOC_PARA  *pMemPara,
                 DWORD                    dwInfoType,
  [out]          void                     **ppvInfo
);

參數

[in] hDescriptor

呼叫 NCryptCreateProtectionDescriptor所建立的保護描述項控制碼。

[in, optional] pMemPara

NCRYPT_ALLOC_PARA 結構的指標 ，可用來指定自訂記憶體管理功能。 如果您將此引數設定為 Null，則會在內部使用 LocalAlloc 函式來配置記憶體，而且您的應用程式必須呼叫 LocalFree 以釋放 ppvInfo 參數所指向的記憶體。

dwInfoType

指定如何將描述項資訊傳回 ppvInfo 參數。 這可以是下列值：

值 意義
NCRYPT_PROTECTION_INFO_TYPE_DESCRIPTOR_STRING
 ppvInfo引數會傳回描述項規則字串。

[out] ppvInfo

描述項資訊的指標。

傳回值

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

傳回碼 描述
ERROR_SUCCESS
 函式成功。
NTE_INVALID_PARAMETER
 ppvInfo參數不可為Null。
NTE_NOT_SUPPORTED
 dwInfoType參數中指定了不支援的值。
NTE_INVALID_HANDLE
 hDescriptor參數指定的控制碼無效。

需求

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

另請參閱

CNG DPAPI 函式

NCryptCreateProtectionDescriptor