ScCopyProps
Hace referencia a: Outlook 2013 | Outlook 2016
Copia las propiedades definidas por una matriz de estructuras SPropValue en un nuevo destino.
| Propiedad | Valor |
|---|---|
| Archivo de encabezado: |
Mapiutil.h |
| Implementado por: |
MAPI |
| Llamado por: |
Aplicaciones cliente y proveedores de servicios |
SCODE ScCopyProps(
int cprop,
LPSPropValue rgprop,
LPVOID pvDst,
ULONG FAR * pcb
);
Parameters
cprop
[in] Recuento de propiedades que se van a copiar.
rgprop
[in] Puntero a una matriz de estructuras SPropValue que definen las propiedades que se van a copiar. El parámetro rgprop no tiene que apuntar al principio de la matriz, pero debe apuntar al principio de una de las estructuras SPropValue de la matriz.
pvDst
[in] Puntero a la posición inicial en la memoria en la que esta función copia las propiedades.
Pcb
[out] Puntero opcional al tamaño, en bytes, del bloque de memoria al que apunta el parámetro pvDst .
Valor devuelto
S_OK
Las propiedades se copiaron correctamente.
MAPI_E_INVALID_PARAMETER
Se encontró un tipo de propiedad desconocido.
Comentarios
La nueva matriz y sus datos residen en un búfer creado con una sola asignación, y la función ScRelocProps se puede usar para ajustar los punteros en las estructuras SPropValue individuales. Antes de este ajuste, los punteros son válidos.
ScCopyProps mantiene el orden de propiedad original para la matriz de propiedades copiadas.
El parámetro pcb es opcional; Si no es NULL, se establece en el número de bytes almacenados en el parámetro pvDst .