HrMAPIAppendSPropValues

The HrMAPIAppendSPropValues function adds an array of one or more MAPI SPropValue structures to the end of an existing array of SPropValue structures.

Quick Info

Header file: EDKMAPI.H
Library: EDKMAPI.LIB

HRESULT HrMAPIAppendSPropValues(
  ULONG cHeadProps,          
  LPSPropValue lpHeadProps,  
  ULONG cTailProps,          
  LPSPropValue lpTailProps,  
  ULONG * lpcNewProps,       
  LPSPropValue * lppNewProps  
);
 

Parameters

cHeadProps
Input parameter. Count of property values pointed to by lpHeadProps.
lpHeadProps
Input parameter. Points to an SPropValue structure containing the existing set of property values.
cTailProps
Input parameter. Count of property values pointed to by lpTailProps.
lpTailProps
Input parameter. Points to an SPropValue structure containing the property values to append to lpHeadProps.
lpcNewProps
Output parameter. Points to the count of property values pointed to by lppNewProps.
lppNewProps
Output parameter. Points to an SPropValue structure containing the resulting set of property values.

Return Values

See Return Values.

Remarks

Use the MAPI IMAPIProp::GetProps method to get a list of properties.

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

For information on the IMAPIProp::GetProps method and SPropValue structure, see the MAPI Programmer's Reference.