ScCopyProps

Gilt für: Outlook 2013 | Outlook 2016

Kopiert die von einem Array von SPropValue-Strukturen definierten Eigenschaften in ein neues Ziel.

SCODE ScCopyProps(
  int cprop,
  LPSPropValue rgprop,
  LPVOID pvDst,
  ULONG FAR * pcb
);

Parameter

cprop

[in] Anzahl der zu kopierenden Eigenschaften.

rgprop

[in] Zeiger auf ein Array von SPropValue-Strukturen , die die zu kopierenden Eigenschaften definieren. Der rgprop-Parameter muss nicht auf den Anfang des Arrays zeigen, aber er muss auf den Anfang einer der SPropValue-Strukturen im Array zeigen.

pvDst

[in] Zeiger auf die anfängliche Position im Arbeitsspeicher, an die diese Funktion die Eigenschaften kopiert.

Pcb

[out] Optionaler Zeiger auf die Größe des Speicherblocks in Bytes, auf den der pvDst-Parameter verweist.

Rückgabewert

S_OK

Eigenschaften wurden erfolgreich kopiert.

MAPI_E_INVALID_PARAMETER

Es wurde ein unbekannter Eigenschaftstyp gefunden.

Hinweise

Das neue Array und die zugehörigen Daten befinden sich in einem Puffer, der mit einer einzelnen Zuordnung erstellt wurde, und die ScRelocProps-Funktion kann verwendet werden, um die Zeiger in den einzelnen SPropValue-Strukturen anzupassen. Vor dieser Anpassung sind die Zeiger gültig.

ScCopyProps behält die ursprüngliche Eigenschaftsreihenfolge für das kopierte Eigenschaftenarray bei.

Der Pcb-Parameter ist optional; Wenn es nicht NULL ist, wird er auf die Anzahl von Bytes festgelegt, die im pvDst-Parameter gespeichert sind.

Siehe auch

ScDupPropset