ScCountNotifications
The ScCountNotifications
function determines the size, in bytes, of an array of event notifications, and
validates the memory associated with the array.
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 ScCountNotifications(
|
int cntf, |
|
|
LPNOTIFICATION rgntf, |
|
|
ULONG FAR * pcb |
|
|
); |
|
Parameters
cntf
[in] Count of
NOTIFICATION
structures in the array indicated by the rgntf parameter.
rgntf
[in] Pointer
to the array of NOTIFICATION structures whose size is to be determined.
pcb
[out]
Optional pointer to the size, in bytes, of the array pointed to by the rgntf
parameter. If NULL, ScCountNotifications validates the array of
notifications.
Remarks
If NULL is
passed in the pcb parameter, the ScCountNotifications function
only validates the array of notifications but no counting is done; if a
non-null value is passed in pcb, ScCountNotifications determines
the size of the array and stores the result in pcb. The pcb
parameter must be large enough to contain the entire array.