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.
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 |
|---|---|
|
The member or the attribute could not be found. |
|
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 |