Platform SDK: MAPI

CMC_X_COM_SUPPORT_EXT

CMC_X_COM_SUPPORT_EXT is a CMC extension that client applications use to query the CMC implementation about the extensions it supports. If the implementation supports any extensions, it must support CMC_X_COM_SUPPORT_EXT.

Quick Info

Header file: XCMCEXT.H

Input Usage

item_data
The number of items in an array pointed to by the item_reference member.
item_reference
Pointer to the first element in an array of CMC_X_COM_support structures listing extensions the client application requests the CMC implementation to support. See CMC_X_COM_support for details.
extension_flags
All flags used with CMC are valid. No further flags are defined.

Output Usage

item_data
Unchanged.
item_reference
Pointer to an array of CMC_X_COM_support structures where the CMC implementation sets the flags in the flags member to indicate support for the requested extensions. The implementation does not set these flags if CMC_X_COM_SUP_EXCLUDE was set on input. See CMC_X_COM_support for details.
extension_flags
Unchanged.

Adds to

The cmc_query_configuration and cmc_logon functions.

Remarks

Client applications can use this extension before establishing a session to get preliminary information about support before logging on. When a client application uses the extension with cmc_logon, it indicates which data extensions the client wants added to the data structures for the session.

Note  The CMC implementation supports different extensions, based on the service with which the client application creates a session. Thus client applications should use CMC_X_COM_SUPPORT_EXT at logon to verify extension support.

See Also

CMC_extension, cmc_logon, cmc_query_configuration, CMC_X_COM_support