ScRelocProps
Gilt für: Outlook 2013 | Outlook 2016
Passt die Zeiger in einem SPropValue-Array an, nachdem das Array und seine Daten kopiert oder an einen neuen Speicherort verschoben wurden.
| Eigenschaft | Wert |
|---|---|
| Headerdatei |
Mapidefs.h |
| Implementiert von: |
MAPI |
| Aufgerufen von: |
Clientanwendungen und Dienstanbieter |
SCODE ScRelocProps(
int cprop,
LPSPropValue rgprop,
LPVOID pvBaseOld,
LPVOID pvBaseNew,
ULONG FAR * pcb
);
Parameter
cprop
[in] Anzahl der Eigenschaften in dem Array, auf das der rgprop-Parameter verweist.
rgprop
[in] Zeiger auf ein Array von SPropValue-Strukturen , für die Zeiger angepasst werden sollen.
pvBaseOld
[in] Zeiger auf die ursprüngliche Basisadresse des Arrays, auf das der rgprop-Parameter verweist.
pvBaseNew
[in] Zeiger auf die neue Basisadresse des Arrays, auf das der rgprop-Parameter zeigt.
Pcb
[in, out] Optionaler Zeiger auf die Größe des Arrays in Bytes, das durch den pvBaseNew-Parameter angegeben wird. Wenn nicht NULL, wird der Pcb-Parameter auf die Anzahl von Bytes festgelegt, die im pvD-Parameter gespeichert sind.
Rückgabewert
S_OK
Zeiger wurden erfolgreich angepasst.
MAPI_E_INVALID_PARAMETER
Ein oder beide Parameter waren ungültig, oder es wurde ein unbekannter Eigenschaftstyp gefunden.
Hinweise
Die ScRelocProps-Funktion geht davon aus, dass das Eigenschaftswertarray, für das Zeiger angepasst werden, ursprünglich in einem einzelnen Aufruf zugeordnet wurde, ähnlich einem Aufruf der ScCopyProps-Funktion . Wenn eine Clientanwendung oder ein Dienstanbieter mit einem Eigenschaftswert arbeitet, der aus nicht zusammenhängenden Speicherblöcken erstellt wird, sollte sie stattdessen ScCopyProps verwenden, um Eigenschaften zu kopieren.
ScRelocProps wird verwendet, um die Gültigkeit von Zeigern in einem SPropValue-Array beizubehalten. Führen Sie die folgenden Vorgänge aus, um die Gültigkeit von Zeigern beim Schreiben und Lesen eines solchen Arrays auf einem Datenträger beizubehalten:
Rufen Sie vor dem Schreiben des Arrays und der Daten auf einen Datenträger ScRelocProps für das Array auf, wobei der Parameter pvBaseNew auf einen Standardwert 0 verweist, für instance.
Rufen Sie nach dem Lesen des Arrays und der Daten von einem Datenträger ScRelocProps für das Array mit dem pvBaseOld-Parameter auf, der dem in Schritt 1 verwendeten Standardwert entspricht. Das Array und die Daten müssen in einen Puffer gelesen werden, der mit einer einzelnen Zuordnung erstellt wurde.
Der Pcb-Parameter für ScRelocProps ist optional.