PpropFindProp

Applies to: Outlook 2013 | Outlook 2016

Searches for a specified property in a property set.

Property Value
Header file:
Mapiutil.h
Implemented by:
MAPI
Called by:
Client applications and service providers
LPSPropValue PpropFindProp(
  LPSPropValue rgprop,
  ULONG cprop,
  ULONG ulPropTag
);

Parameters

rgprop

[in] Array of SPropValue structures that define the properties to be searched.

cprop

[in] Count of properties in the property set indicated by the rgprop parameter.

ulPropTag

[in] Property tag for the property to search for in the property set indicated by the rgprop parameter.

Return value

PpropFindProp returns an SPropValue structure defining the property that matches the input property tag, or NULL if there is no match.

Remarks

If the given property tag indicates a property of type PT_UNSPECIFIED, the PpropFindProp function finds a match only for the property identifier in the tag. Otherwise, it finds a match for the entire property tag, including the property type, and returns the property identified.

MFCMAPI reference

For MFCMAPI sample code, see the following table.

File Function Comment
ContentsTableListCtrl.cpp
CContentsTableListCtrl::BuildDataItem
MFCMAPI uses the PpropFindProp method to find properties in a property set being added to the list.

See also

MFCMAPI as a Code Sample