Platform SDK: Exchange Server

HrMAPIFindMsgByProp

The HrMAPIFindMsgByProp function retrieves the entry identifier of a message through a property.

Quick Info

Header file:	EDKMAPI.H
Library:	EDKMAPI.LIB

HRESULT HrMAPIFindMsgByProp(
  LPMAPIFOLDER lpFolder,  
  LPSPropValue lpSPropValue,  
  LPENTRYLIST * lppMsgList  
);

Parameters

lpFolder: Input parameter. Points to a MAPI IMAPIFolder interface containing the folder.
lpSPropValue: Input parameter. Points to a MAPI SPropValue structure containing the property.
lppMsgList: Output parameter. List of matching messages.

Return Values

See Return Values.

Remarks

The HrMAPIFindMsgByProp function creates a list of messages in lppMsgList whose property, including value, match that specified by the property in lpSPropValue.

For more information on this function, see the HrMAPIFindMsgByProp function in IMESSAGE.C under the EDKMAPI code sample in the Code Samples folder.

For information on the IMAPIFolder interface and SPropValue structure, see the MAPI Programmer's Reference.