ScCopyNotifications
The ScCopyNotifications
function copies a group of event notifications to a single block of memory.
Note This function
may not be supported in future versions of MAPI.
Quick Info
|
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 |
|
|
); |
|
Parameters
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.
Remarks
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.