Partager via


PpropFindProp

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

Searches for a specified property in a property set.

Header file:

Mapiutil.h

Implemented by:

MAPI

Called by:

Client applications and service providers

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, and 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

Concepts

MFCMAPI as a Code Sample