Platform SDK: Exchange Server

IExchExtMessageEvents::OnCheckNames

Replaces or enhances the behavior of Microsoft Exchange when recipient names typed by the user are being resolved to their address book entries.

Quick Info

See IExchExtMessageEvents : IUnknown.

HRESULT OnCheckNames(
  LPEXCHEXTCALLBACK lpeecb  
);
 

Parameters

lpeecb
[in] Pointer to the IExchExtCallback interface. The lpeecb parameter is used to determine information about the message and the window containing the unresolved names.

Return Values

S_OK
The extension object replaced Microsoft Exchange behavior and handled the name resolution on its own. Microsoft Exchange will consider the task handled.
S_FALSE
The extension object did nothing or added additional behavior. See the text provided in the definition of the IExchExtMessageEvents interface in this reference.

Remarks

Microsoft Exchange calls the IExchExtMessageEvents::OnCheckNames method when it is about to resolve unresolved names.

If an error occurs, OnCheckNames should display an error message and return an error. Microsoft Exchange will not continue to check names, nor will it display an error message, but will stop the user action that caused the check names operation. This method should call the IExchExtCallback::GetObject method to determine the message identifier of the item being displayed and its container. The container is usually a folder, but it can also be a message or an information store.

See Also

IExchExtCallback::GetObject, IExchExtMessageEvents : IUnknown