Important:
This is retired content. 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 content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
4/8/2010

The HrGetOnePropfunction retrieves the value of a single property from an object that support properties, such as an IAttach, a IMAPIContainer, a IMAPIFolder, a IMessage, or a IMsgStore.

Note:
This function may be deprecated in future versions of MAPI

Syntax

HRESULT HrGetOneProp(
  LPMAPIPROP 
lpMapiProp
  ULONG 
ulPropTag
  LPSPropValue FAR* 
lppProp
);

Parameters

lpMapiProp

[in] Reference to the object from which the property value is to be retrieved—which implements the IMAPIPropinterface.

ulPropTag

[in] Property tag of the property to be retrieved.

lppProp

[out] Pointer to a pointer to the returned SPropValuestructure defining the retrieved property value.

Property Value/Return Value

This function returns an appropriate HRESULTvalue, such as the following:

S_OK

The function successfully returned the value of a single property.

MAPI_E_NOT_FOUND

The requested property cannot be found on the target object.

Remarks

Unlike the IMAPIProp::GetPropsmethod, HrGetOnePropnever returns a warning. Because it retrieves only one property, it either succeeds or fails. For retrieving multiple properties, use IMAPIProp::GetProps.

You can set or change a single property with the HrSetOnePropfunction.

Requirements

Header mapiutil.h
Library cemapi.lib
Windows Mobile Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later

See Also