GetInstance

Applies to: Outlook 2013 | Outlook 2016

Copies one value within a multivalued property to a single-valued property of the same type.

Property	Value
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 SPropValue 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.

None.

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