Edit

CryptCATPutMemberInfo function (mscat.h)

  • Article

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

The CryptCATPutMemberInfo function allocates memory for a catalog member and adds it to the catalog.

Syntax

CRYPTCATMEMBER * CryptCATPutMemberInfo(
  [in]           HANDLE hCatalog,
  [in, optional] LPWSTR pwszFileName,
  [in]           LPWSTR pwszReferenceTag,
  [in]           GUID   *pgSubjectType,
  [in]           DWORD  dwCertVersion,
  [in]           DWORD  cbSIPIndirectData,
  [in]           BYTE   *pbSIPIndirectData
);

Parameters

[in] hCatalog

A handle to the catalog obtained from the CryptCATOpen or CryptCATHandleFromStore function.

[in, optional] pwszFileName

A pointer to a null-terminated string for the catalog file name.

[in] pwszReferenceTag

A pointer to a null-terminated string that contains the name of the member.

[in] pgSubjectType

A GUID for the subject type of the member.

[in] dwCertVersion

A value that specifies the certificate version.

[in] cbSIPIndirectData

A value that specifies the number of bytes in the pbSIPIndirectData buffer.

[in] pbSIPIndirectData

A pointer to a memory buffer for subject interface package (SIP)-indirect data.

Return value

A pointer to a CRYPTCATMEMBER structure that contains the assigned member. The caller must not free this pointer or any of its members.

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
ERROR_INVALID_PARAMETER
 One or more of the parameters are not valid.
ERROR_NOT_ENOUGH_MEMORY
 The operating system ran out of memory during the operation.

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