ScCopyNotifications

Gilt für: Outlook 2013 | Outlook 2016

Kopiert eine Gruppe von Ereignisbenachrichtigungen in einen einzelnen Speicherblock.

Eigenschaft	Wert
Headerdatei	Mapiutil.h
Implementiert von:	MAPI
Aufgerufen von:	Clientanwendungen und Dienstanbieter

SCODE ScCopyNotifications(
  int cntf,
  LPNOTIFICATION rgntf,
  LPVOID pvDst,
  ULONG FAR * pcb
);

Parameter

cntf

[in] Anzahl der NOTIFICATION-Strukturen im Array, die durch den rgntf-Parameter angegeben wird.

rgntf

[in] Zeiger auf ein Array von NOTIFICATION-Strukturen , die die zu kopierenden Ereignisbenachrichtigungen definieren.

pvDst

[out] Zeiger auf die zurückgegebenen Benachrichtigungen.

Pcb

[out] Optionaler Zeiger auf eine Variable, in der die Größe des Arrays in Bytes gespeichert wird, auf das der rgntf-Parameter verweist. Wenn nicht NULL, wird der pcb-Parameter auf die Anzahl der bytes festgelegt, die im pvDst-Parameter gespeichert sind.

Rückgabewert

S_OK

Ereignisbenachrichtigungen wurden erfolgreich kopiert.

E_INVALIDARG

Es wurde eine ungültige Benachrichtigung gefunden.

Hinweise

Wenn NULL im Pcb-Parameter übergeben wird, wird kein Kopiervorgang ausgeführt. Wenn ein Wert ungleich NULL in der Platine übergeben wird, kopiert die ScCopyNotifications-Funktion die Größe des Arrays und des Arrays selbst in einen einzelnen Speicherblock. Wenn pcb nicht NULL ist, wird sie auf die Anzahl von Bytes festgelegt, die im pvDst-Parameter gespeichert sind. Der parameter pvDst muss groß genug sein, um das gesamte Array zu enthalten.