ScRelocProps
S’applique à : Outlook 2013 | Outlook 2016
Ajuste les pointeurs dans un tableau SPropValue une fois que le tableau et ses données ont été copiés ou déplacés vers un nouvel emplacement.
| Propriété | Valeur |
|---|---|
| Fichier d’en-tête : |
Mapidefs.h |
| Implémenté par : |
MAPI |
| Appelé par : |
Applications clientes et fournisseurs de services |
SCODE ScRelocProps(
int cprop,
LPSPropValue rgprop,
LPVOID pvBaseOld,
LPVOID pvBaseNew,
ULONG FAR * pcb
);
Paramètres
cprop
[in] Nombre de propriétés dans le tableau vers lequel pointe le paramètre rgprop .
rgprop
[in] Pointeur vers un tableau de structures SPropValue pour lesquelles les pointeurs doivent être ajustés.
pvBaseOld
[in] Pointeur vers l’adresse de base d’origine du tableau vers lequel pointe le paramètre rgprop .
pvBaseNew
[in] Pointeur vers la nouvelle adresse de base du tableau vers lequel pointe le paramètre rgprop .
Pcb
[in, out] Pointeur facultatif vers la taille, en octets, du tableau indiquée par le paramètre pvBaseNew . S’il n’est pas NULL, le paramètre de circuit imprimé est défini sur le nombre d’octets stockés dans le paramètre pvD .
Valeur renvoyée
S_OK
Les pointeurs ont été ajustés avec succès.
MAPI_E_INVALID_PARAMETER
Un ou les deux paramètres n’étaient pas valides, ou un type de propriété inconnu a été rencontré.
Remarques
La fonction ScRelocProps part de l’hypothèse que le tableau de valeurs de propriété pour lequel les pointeurs sont ajustés a été initialement alloué dans un seul appel similaire à un appel à la fonction ScCopyProps . Si une application cliente ou un fournisseur de services utilise une valeur de propriété générée à partir de blocs de mémoire disjoints, il doit utiliser ScCopyProps pour copier les propriétés à la place.
ScRelocProps est utilisé pour maintenir la validité des pointeurs dans un tableau SPropValue . Pour maintenir la validité des pointeurs lors de l’écriture d’un tableau dans et de sa lecture à partir d’un disque, effectuez les opérations suivantes :
Avant d’écrire le tableau et les données sur un disque, appelez ScRelocProps sur le tableau avec le paramètre pvBaseNew pointant vers une valeur standard zéro, pour instance.
Après avoir lu le tableau et les données d’un disque, appelez ScRelocProps sur le tableau avec le paramètre pvBaseOld égal à la même valeur standard utilisée à l’étape 1. Le tableau et les données doivent être lus dans une mémoire tampon créée avec une seule allocation.
Le paramètre de circuit impriméde ScRelocProps est facultatif.