[ новости /+++ | форум | теги | ]

NAME
     csa_x_process_updates  -  invoke  a  calendar  application's
     calendar event handler

SYNOPSIS
     #include <csa.h>
     void csa_x_process_updates(CSA_session_handle cal);

DESCRIPTION
     The csa_x_process_updates() function checks to see if  there
     have  been  calendar  updates  that  are  of interest to the
     client.  If there have been one or  more  calendar  updates,
     and  the  client  previously  registered  a callback handler
     using csa_register_callback(3) for updates of this type, the
     callback function is called by csa_x_process_updates().

     The cal argument specifies a calendar session  handle.   The
     callback  function  will  be invoked only if there have been
     updates to this calendar.  If cal is set to NULL, the  call-
     back  function will be invoked if there have been updates to
     any logged on calendars.

RETURN VALUE
     The csa_x_process_updates() function returns no value.

APPLICATION USAGE
     The csa_x_process_updates() function is useful for  applica-
     tions  that  maintain  a  dynamic representation of calendar
     information, such as a GUI calendar  display.   Because  the
     calendar   server   can   simultaneously  maintain  multiple
     read/write connections  for  the  same  calendar,  any  data
     retrieved  by  a client should be considered immediately out
     of date.  To create the appearance of a dynamic  display  of
     calendar    data,    such   an   application   should   call
     csa_x_process_updates()  as  frequently  as  necessary  from
     within its main event loop.

     One way to do  this  is  to  have  a  timeout  handler  call
     csa_x_process_updates()  at regular intervals.  The duration
     of the timer should be appropriate  for  the  expected  user
     environment.  This does not eliminate the risk of the client
     holding outdated information; it merely gives  the  applica-
     tion control over how old the information can get.

SEE ALSO
     csa(5), csa_register_callback(3).

Партнёры:

Хостинг: