ScCopyProps
Gilt für: Outlook 2013 | Outlook 2016
Kopiert die von einem Array von SPropValue-Strukturen definierten Eigenschaften in ein neues Ziel.
| Eigenschaft | Wert |
|---|---|
| Headerdatei |
Mapiutil.h |
| Implementiert von: |
MAPI |
| Aufgerufen von: |
Clientanwendungen und Dienstanbieter |
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.