PropCopyMore

Gilt für: Outlook 2013 | Outlook 2016

Kopiert einen einzelnen Eigenschaftswert von einem Quellspeicherort in einen Zielspeicherort.

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

Parameter

lpSPropValueDest

[out] Zeiger auf den Speicherort, an den diese Funktion eine SPropValue-Struktur schreibt, die den kopierten Eigenschaftswert definiert.

lpSPropValueSrc

[in] Zeiger auf die SPropValue-Struktur , die den zu kopierenden Eigenschaftswert enthält.

lpfAllocMehr

[in] Zeiger auf die MAPIAllocateMore-Funktion , die zum Zuweisen von zusätzlichem Arbeitsspeicher verwendet werden soll, wenn der Zielspeicherort nicht groß genug ist, um die zu kopierende Eigenschaft zu speichern.

lpvObject

[in] Zeiger auf ein Objekt, für das MAPIAllocateMore bei Bedarf Speicherplatz zuweist.

Rückgabewert

S_OK

Der einzelne Eigenschaftswert wurde erfolgreich kopiert.

MAPI_E_NO_SUPPORT

Es wurde ein unbekannter Eigenschaftstyp gefunden.

Hinweise

Eine Clientanwendung oder ein Dienstanbieter kann die PropCopyMore-Funktion verwenden, um eine Eigenschaft aus einer Tabelle zu kopieren, die freigegeben werden soll, um sie an anderer Stelle zu verwenden.

PropCopyMore muss keinen Arbeitsspeicher zuordnen, es sei denn, der kopierte Eigenschaftswert ist von einem Typ wie PT_STRING8, der nicht in eine SPropValue-Struktur passt. Für diese großen Eigenschaften belegt die Funktion Speicher mithilfe der MAPIAllocateMore-Funktion , an die ein Zeiger im lpfAllocMore-Parameter übergeben wird.

Unwürdige Verwendung von PropCopyMehr Fragmenten Memory; Erwägen Sie stattdessen die Verwendung der ScCopyProps-Funktion .