Expand Minimize

ScCopyNotifications

Published: July 16, 2012

Copies a group of event notifications to a single block of memory.

Header file:

Mapiutil.h

Implemented by:

MAPI

Called by:

Client applications and service providers

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

cntf

[in] Count of NOTIFICATION structures in the array indicated by the rgntf parameter.

rgntf

[in] Pointer to an array of NOTIFICATION structures defining the event notifications to be copied.

pvDst

[out] Pointer to the returned notifications.

pcb

[out] Optional pointer to a variable where the size, in bytes, of the array pointed to by the rgntf parameter is stored. If not NULL, the pcb parameter is set to the number of bytes stored in the pvDst parameter.

S_OK

Event notifications were copied successfully.

E_INVALIDARG

An invalid notification was encountered.

If NULL is passed in the pcb parameter, no copying is performed; if a non-null value is passed in pcb, the ScCopyNotifications function copies the size of the array and the array itself to a single block of memory. If pcb is not NULL, it is set to the number of bytes stored in the pvDst parameter. The pvDst parameter must be large enough to contain the entire array.

Community Additions

ADD
Show:
© 2014 Microsoft