This documentation is archived and is not being maintained.


This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This page may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

Determines the size, in bytes, of an array of event notifications, and validates the memory associated with the array.

Header file:


Implemented by:


Called by:

Client applications and service providers

SCODE ScCountNotifications(
  int cntf,
  ULONG FAR * pcb


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


[in] Pointer to the array of NOTIFICATION structures whose size is to be determined.


[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.


Count was determined successfully.


An invalid notification was encountered.

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 cause pcb. The pcb parameter must be large enough to contain the entire array.