HrGetOneProp
The HrGetOneProp
function retrieves the value of a single property from an IMAPIProp interface or an interface derived
from IMAPIProp.
Note This function
may not be supported in future versions of MAPI.
Quick Info
|
Header
file: |
MAPIUTIL.H |
|
Implemented
by: |
MAPI |
|
Called by: |
Client
applications and service providers |
HrGetOneProp(
|
LPMAPIPROP pmp, |
|
|
ULONG ulPropTag,
|
|
|
LPSPropValue FAR * ppprop |
|
|
); |
|
Parameters
pmp
[in] Pointer
to the interface from which the property value is to be retrieved.
ulPropTag
[in] Property
tag of the property to be retrieved.
ppprop
[out] Pointer
to a pointer to the returned SPropValue structure defining the retrieved property
value.
Return Values
MAPI_E_NOT_FOUND
The requested
object does not exist.
Remarks
Unlike the IMAPIProp::GetProps method, the HrGetOneProp
function does not return any warning. Because it retrieves only one property,
it simply either succeeds or fails. To retrieve multiple properties, a client
application or service provider should call GetProps.
See Also
HrSetOneProp