Partager via

PropCopyMore

  • Article

S’applique à : Outlook 2013 | Outlook 2016

Copie une valeur de propriété unique à partir d’un emplacement source vers un emplacement de destination.

Propriété Valeur
Fichier d’en-tête :
 Mapiutil.h
Implémenté par :
 MAPI
Appelé par :
 Applications clientes et fournisseurs de services
 
SCODE PropCopyMore(
  LPSPropValue lpSPropValueDest,
  LPSPropValue lpSPropValueSrc,
  ALLOCATEMORE * lpfAllocMore,
  LPVOID lpvObject
);

Paramètres

lpSPropValueDest

[out] Pointeur vers l’emplacement dans lequel cette fonction écrit une structure SPropValue définissant la valeur de propriété copiée.

lpSPropValueSrc

[in] Pointeur vers la structure SPropValue qui contient la valeur de propriété à copier.

lpfAllocPlus

[in] Pointeur vers la fonction MAPIAllocateMore à utiliser pour allouer de la mémoire supplémentaire si l’emplacement de destination n’est pas assez grand pour contenir la propriété à copier.

lpvObject

[in] Pointeur vers un objet pour lequel MAPIAllocateMore allouera de l’espace si nécessaire.

Valeur renvoyée

S_OK

La valeur de propriété unique a été copiée avec succès.

MAPI_E_NO_SUPPORT

Un type de propriété inconnu a été rencontré.

Remarques

Une application cliente ou un fournisseur de services peut utiliser la fonction PropCopyMore pour copier une propriété d’une table qui est sur le point d’être libérée afin de l’utiliser ailleurs.

PropCopyMore n’a pas besoin d’allouer de mémoire, sauf si la valeur de propriété copiée est d’un type, tel que PT_STRING8, qui ne tient pas dans une structure SPropValue . Pour ces propriétés volumineuses, la fonction alloue de la mémoire à l’aide de la fonction MAPIAllocateMore vers laquelle un pointeur est passé dans le paramètre lpfAllocMore .

L’utilisation préjudiciable de PropCopyMore fragmente la mémoire ; envisagez d’utiliser la fonction ScCopyProps à la place.