Partager via

GetInstance

  • Article

This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

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

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.

Return Value

None.

Remarks

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