RSA BSAFE Cert-C API Reference

RECIPIENT_INFO Struct Reference

Holds message recipient information.

The RECIPIENT_INFO structure holds information associated with a single recipient of a CMS message (supported) or a PKI message (deprecated). The subordinate KEY_TRANSPORT_INFO structure is used to determine or obtain the key used to encrypt an internal content-encryption key.

• In a CMS message, the RECIPIENT_INFO structure holds information about a single recipient of a CMS message.

The RECIPIENT_INFO structure is used by the C_ReadEnvelopedDataMsg(), C_WriteEnvelopedDataMsg(), C_AddRecipientToList(), C_AddUniqueRecipientToList(), C_InsertRecipientInList(), C_FreeRecipientEntry(), and C_FreeRecipientInfo() functions.

• In a PKI message, the PKI_RECIPIENT structure uses a RECIPIENT_INFO structure to hold information about a single recipient of a PKI message.

However, the use of the PKI_RECIPIENT structure is deprecated in Cert-C 2.0. Use the PKI_RECIPIENT_INFO structure (and its related C_SetPKIMsgRecipient() and C_GetPKIMsgRecipient() functions) instead.

Data Fields

type	An int value that identifies the type of data structure in the info union. Cert-C supports the following recipient information type: Recipient Information Type Description KEY_TRANSPORT Contains a KEY_TRANSPORT_INFO data structure.
info	A union that contains recipient information in the format specified by type.
keyTrans	A KEY_TRANSPORT_INFO structure.

#include <cms.h>

typedef struct {
  int type;
  union {
    KEY_TRANSPORT_INFO keyTrans;
  } info;
} RECIPIENT_INFO;

---

The documentation for this struct was generated from the following file:

• cms.h

---

RSA BSAFE^® Cert-C 2.7 API Reference