ScCopyProps
S’applique à : Outlook 2013 | Outlook 2016
Copie les propriétés définies par un tableau de structures SPropValue vers une nouvelle destination.
Propriété | Valeur |
---|---|
Fichier d’en-tête : |
Mapiutil.h |
Implémenté par : |
MAPI |
Appelé par : |
Applications clientes et fournisseurs de services |
SCODE ScCopyProps(
int cprop,
LPSPropValue rgprop,
LPVOID pvDst,
ULONG FAR * pcb
);
Paramètres
cprop
[in] Nombre de propriétés à copier.
rgprop
[in] Pointeur vers un tableau de structures SPropValue qui définissent les propriétés à copier. Le paramètre rgprop n’a pas besoin de pointer vers le début du tableau, mais il doit pointer vers le début de l’une des structures SPropValue dans le tableau.
pvDst
[in] Pointeur vers la position initiale en mémoire vers laquelle cette fonction copie les propriétés.
Pcb
[out] Pointeur facultatif vers la taille, en octets, du bloc de mémoire vers lequel pointe le paramètre pvDst .
Valeur renvoyée
S_OK
Les propriétés ont été copiées avec succès.
MAPI_E_INVALID_PARAMETER
Un type de propriété inconnu a été rencontré.
Remarques
Le nouveau tableau et ses données résident dans une mémoire tampon créée avec une seule allocation, et la fonction ScRelocProps peut être utilisée pour ajuster les pointeurs dans les structures SPropValue individuelles. Avant cet ajustement, les pointeurs sont valides.
ScCopyProps conserve l’ordre de propriété d’origine pour le tableau de propriétés copié.
Le paramètre de circuit imprimé est facultatif ; s’il n’est pas NULL, il est défini sur le nombre d’octets stockés dans le paramètre pvDst .