PropCopyMore

Hace referencia a: Outlook 2013 | Outlook 2016

Copia un valor de propiedad único de una ubicación de origen en una ubicación de destino.

Propiedad	Valor
Archivo de encabezado:	Mapiutil.h
Implementado por:	MAPI
Llamado por:	Aplicaciones cliente y proveedores de servicios

SCODE PropCopyMore(
  LPSPropValue lpSPropValueDest,
  LPSPropValue lpSPropValueSrc,
  ALLOCATEMORE * lpfAllocMore,
  LPVOID lpvObject
);

Parameters

lpSPropValueDest

[out] Puntero a la ubicación en la que esta función escribe una estructura SPropValue que define el valor de la propiedad copiada.

lpSPropValueSrc

[in] Puntero a la estructura SPropValue que contiene el valor de propiedad que se va a copiar.

lpfAllocMore

[in] Puntero a la función MAPIAllocateMore que se usará para asignar memoria adicional si la ubicación de destino no es lo suficientemente grande como para contener la propiedad que se va a copiar.

lpvObject

[in] Puntero a un objeto para el que MAPIAllocateMore asignará espacio si es necesario.

Valor devuelto

S_OK

El valor de propiedad única se copió correctamente.

MAPI_E_NO_SUPPORT

Se encontró un tipo de propiedad desconocido.

Comentarios

Una aplicación cliente o un proveedor de servicios puede usar la función PropCopyMore para copiar una propiedad de una tabla que está a punto de liberarse con el fin de usarla en otro lugar.

PropCopyMore no necesita asignar memoria a menos que el valor de propiedad copiado sea de un tipo, como PT_STRING8, que no cabe en una estructura SPropValue . Para estas propiedades grandes, la función asigna memoria mediante la función MAPIAllocateMore a la que se pasa un puntero en el parámetro lpfAllocMore .

Uso injudicio de la memoria de fragmentos de PropCopyMore ; considere la posibilidad de usar la función ScCopyProps en su lugar.