GetInstance 

The GetInstance function copies one value within a multivalued property to a single-valued property of the same type.

 

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

 

VOID GetInstance(

    LPSPropValue pvalMv,

 

    LPSPropValue pvalSv,

 

    ULONG uliInst

 

   );

 

 

Parameters

pvalMv

[in] Pointer to an SPropValue81C9._8 structure defining a multivalued property.

pvalSv

[in] Pointer to a single-valued property to receive data.

uliInst

[in] The instance number   that is, the array element   of the value being copied from the structure indicated by the pvalMv parameter.

 

Remarks

If the value copied is too large for the allocated memory, the GetInstance function only copies pointers rather than allocating new memory.