3 Protocol Details

The Wire Format Protocol contains two RPC interfaces: EMSMDB, as specified in section 3.1 and section 3.2, and AsyncEMSMDB as specified in section 3.3 and section 3.4.

For some functionality through the EMSMDB interface, the client is required to first establish a session context handle by a successful call to the EcDoConnectEx method, as specified in section 3.1.4.1. The session context handle is an RPC context handle. All method calls that require a valid session context handle are listed in the following table.

Session context handle–based methods

Interface

EcDoDisconnect

EMSMDB

EcRRegisterPushNotification

EMSMDB

EcDoRpcExt2

EMSMDB

EcDoAsyncConnectEx

EMSMDB

For some functionality through the AsyncEMSMDB interface, the client is required to call specific interface methods first to establish an asynchronous context handle. The asynchronous context handle is an RPC context handle. To establish an asynchronous context handle, a call to the EcDoAsyncConnectEx method on the EMSMDB interface MUST be successful. All method calls that require a valid asynchronous context handle are listed in the following table.

Asynchronous context handle–based methods

Interface

EcDoAsyncWaitEx

AsyncEMSMDB