ScRelocProps
Hace referencia a: Outlook 2013 | Outlook 2016
Ajusta los punteros de una matriz SPropValue después de que la matriz y sus datos se hayan copiado o movido a una nueva ubicación.
| Propiedad | Valor |
|---|---|
| Archivo de encabezado: |
Mapidefs.h |
| Implementado por: |
MAPI |
| Llamado por: |
Aplicaciones cliente y proveedores de servicios |
SCODE ScRelocProps(
int cprop,
LPSPropValue rgprop,
LPVOID pvBaseOld,
LPVOID pvBaseNew,
ULONG FAR * pcb
);
Parameters
cprop
[in] Recuento de propiedades de la matriz a la que apunta el parámetro rgprop .
rgprop
[in] Puntero a una matriz de estructuras SPropValue para las que se van a ajustar los punteros.
pvBaseOld
[in] Puntero a la dirección base original de la matriz a la que apunta el parámetro rgprop .
pvBaseNew
[in] Puntero a la nueva dirección base de la matriz a la que apunta el parámetro rgprop .
Pcb
[entrada, salida] Puntero opcional al tamaño, en bytes, de la matriz indicada por el parámetro pvBaseNew . Si no es NULL, el parámetro pcb se establece en el número de bytes almacenados en el parámetro pvD .
Valor devuelto
S_OK
Los punteros se ajustaron correctamente.
MAPI_E_INVALID_PARAMETER
Uno o ambos parámetros no eran válidos o se encontró un tipo de propiedad desconocido.
Comentarios
La función ScRelocProps funciona suponiendo que la matriz de valores de propiedad para la que se ajustan los punteros se asignó originalmente en una sola llamada similar a una llamada a la función ScCopyProps . Si una aplicación cliente o un proveedor de servicios trabaja con un valor de propiedad que se compila a partir de bloques de memoria separados, debe usar ScCopyProps para copiar propiedades en su lugar.
ScRelocProps se usa para mantener la validez de los punteros en una matriz SPropValue . Para mantener la validez de los punteros al escribir dicha matriz en y leerla desde un disco, realice las siguientes operaciones:
Antes de escribir la matriz y los datos en un disco, llame a ScRelocProps en la matriz con el parámetro pvBaseNew que apunta a algún valor estándar cero, por ejemplo.
Después de leer la matriz y los datos de un disco, llame a ScRelocProps en la matriz con el parámetro pvBaseOld igual al mismo valor estándar usado en el paso 1. La matriz y los datos se deben leer en un búfer creado con una sola asignación.
El parámetro pcb para ScRelocProps es opcional.