cryptCATGetAttrInfo 函数 (mscat.h)

[ CryptCATGetAttrInfo 函数可用于“要求”部分中指定的操作系统。它在后续版本中可能已更改或不可用。]

CryptCATGetAttrInfo 函数检索有关目录成员的属性的信息。

语法

CRYPTCATATTRIBUTE * CryptCATGetAttrInfo(
  [in] HANDLE         hCatalog,
  [in] CRYPTCATMEMBER *pCatMember,
  [in] LPWSTR         pwszReferenceTag
);

[in] hCatalog

包含要检索其属性信息的成员的目录的句柄。此句柄是通过调用 CryptCATOpen 函数获取的。此参数是必需的，不能为 NULL。

[in] pCatMember

指向 CRYPTCATMEMBER 结构的指针，该结构表示要检索其属性信息的成员。这可以通过调用 CryptCATGetMemberInfo 函数获得。此参数是必需的，不能为 NULL。

[in] pwszReferenceTag

指向以 null 结尾的 Unicode 字符串的指针，该字符串包含要检索其信息的属性的名称。此参数是必需的，不能为 NULL。

此函数返回指向包含属性信息的 CRYPTCATATTRIBUTE 结构的指针。如果函数失败，它将返回 NULL。

重要不要释放返回的指针，也不要释放返回的指针指向的任何成员。

如果此函数返回 NULL，则可以通过调用 GetLastError 函数获取其他错误信息。 GetLastError 将返回以下错误代码之一。

返回代码	说明
CRYPT_E_NOT_FOUND	找不到成员或属性。
ERROR_INVALID_PARAMETER	一个或多个参数无效。