Developer

API Reference

IvCalObject_GetNumberOfProperties()

Brew Release
Brew MP 1.0.2
See Also
IvCalObject_GetPropertyAtIndex IvCalObject_GetNumPropertiesById IvCalObject_GetNumPropertiesByName
Description
Returns the number of properties
Passing nPropId=0, will tell total number of properties assosciated with this object
Parameters
  • pIvCalObject
    []:
    Pointer to the interface object
  • nPropId
    []:
    Property Id, for which we want to check the number of occurrences
  • pnNumProps
    []:
    Upon successful return contains the number of properties for that particular property id
Interface
Prototype
   int IvCalObject_GetNumberOfProperties(IvCalObject   *pIvCalObject,
                                         AEEVProperty  nPropId,
                                         int           *pnNumProps);
Return
Returns the AEE return value
AEE_SUCCESS : If we are able to successfully return the count AEE_EBADPARM : If either nPropId is invalid or pnNumProps is NULL
Side Effect
None
Comment
In calendar we may have some properties repeat more than once. This function is useful in knowing such number of properties
ATTENDEE;CN="anybody,anyone";ROLE=REQ-PARTICIPANT;RSVP=TRUE:MAILTO:anybody@anywhere.com
ATTENDEE;CN="nobody,noone";ROLE=REQ-PARTICIPANT;RSVP=TRUE:MAILTO:nobody@anywhere.com
ATTENDEE;CN="someone,somewhere";ROLE=REQ-PARTICIPANT;RSVP=TRUE:MAILTO:someone@anywhere.com
For the above example, if the user queries with the AEEVPROPERTY_ATTENDEE upon return pnNumProps would be 3
  • Follow