CryptCATGetAttrInfo function (mscat.h)

[The CryptCATGetAttrInfo function is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

The CryptCATGetAttrInfo function retrieves information about an attribute of a member of a catalog.

Syntax

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

Parameters

[in] hCatalog

The handle of the catalog that contains the member to retrieve the attribute information for. This handle is obtained by calling the CryptCATOpen function. This parameter is required and cannot be NULL.

[in] pCatMember

A pointer to a CRYPTCATMEMBER structure that represents the member to retrieve the attribute information for. This can be obtained by calling the CryptCATGetMemberInfo function. This parameter is required and cannot be NULL.

[in] pwszReferenceTag

A pointer to a null-terminated Unicode string that contains the name of the attribute to retrieve the information for. This parameter is required and cannot be NULL.

Return value

This function returns a pointer to a CRYPTCATATTRIBUTE structure that contains the attribute information. If the function fails, it returns NULL.

Important  Do not free the returned pointer nor any of the members pointed to by the returned pointer.
 

If this function returns NULL, additional error information can be obtained by calling the GetLastError function. GetLastError will return one of the following error codes.

Return code Description
CRYPT_E_NOT_FOUND
The member or the attribute could not be found.
ERROR_INVALID_PARAMETER
One or more of the parameters are not valid.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header mscat.h
Library Wintrust.lib
DLL Wintrust.dll

See also

CRYPTCATATTRIBUTE

CRYPTCATMEMBER

CryptCATGetMemberInfo

CryptCATOpen