CMC_X_COM_RECIP_ID

CMC_X_COM_RECIP_ID is a CMC extension that adds a unique recipient identifier to a CMC_recipient structure. A recipient identifier is an opaque object that the underlying messaging system uses to uniquely represent a recipient, and can be thought of as the result of resolving an address.

Quick Info

Input Usage

item_data

The length in bytes of the recipient identifier.

item_reference

Pointer to the recipient identifier.

extension_flags

All flags used with the CMC_extension structure are valid. No further flags are defined.

Output Usage

item_data

The length in bytes of the recipient identifier.

item_reference

Pointer to the recipient identifier.

extension_flags

Unchanged.

Adds to

The CMC_recipient structure.

Remarks

The CMC implementation handles the CMC_X_COM_RECIP_ID extension during recipient name resolution. The client application can use this to avoid further name resolution during sending. Some message services allow the client application to reuse the recipient identifier returned by a previous call to cmc_look_up. The client application can attach it to a recipient structure that the service provider would otherwise try to resolve.

At logon, the client application passes the item_code member of CMC_X_COM_RECIP_ID in the CMC_X_COM_SUPPORT_EXT array to request that the CMC implementation should attach recipent identifiers to CMC_recipient structures during the session.

See Also

CMC_extension, CMC_recipient, CMC_X_COM_support