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.