hpux man page for csa_call_callbacks

csa_call_callbacks(library call)										  csa_call_callbacks(library call)

NAME
       csa_call_callbacks -- force the invocation of the callback functions associated with the specified callback list(s)

SYNOPSIS
       #include <xcsa.h>
       CSA_return_code csa_call_callbacks(
       CSA_session_handle session,
       CSA_flags reason,
       CSA_extension *call_callbacks_extensions);

DESCRIPTION
       The  csa_call_callbacks	function  causes  the  service to call the registered callback functions associationed with the specified callback
       list(s).  The service will process each specified callback list and call the registered callback functions if there have been changes  that
       would trigger the callbacks of that type.  The order in which callbacks are invoked is implementation specific.

   Session (Session Handle)
       Opaque session handle that represents a session with the calendaring service.

       If  a valid session handle is specified, the callback functions registered with that session are invoked.  Session handles are created by a
       logon function call and invalidated with a logoff function call.  If the session handle	is  invalid,  then  the  error	CSA_E_INVALID_SES-
       SION_HANDLE is returned.

   Reason (Flags)
       A bitmask of flags.  Unspecified flags should always be passed as 0.  Undocumented flags are reserved.  Each flag corresponds to a callback
       activity.  Flag settings include:

       CSA_CB_CALENDAR_LOGON
		 If set, the new callback will be invoked when a the calendar is accessed by a user.

       CSA_CB_CALENDAR_DELETED
		 If set, the new callback will be invoked when a user requests that the calendar be deleted.

       CSA_CB_CALENDAR_ATTRIBUTE_UPDATED
		 If set, the new callback will be invoked whenever a calendar attribute is updated.

       CSA_CB_ENTRY_ADDED
		 If set, the new callback will be invoked whenever an entry is added to the calendar.

       CSA_CB_ENTRY_DELETED
		 If set, the new callback will be invoked whenever an entry is deleted from the calendar.

       CSA_CB_ENTRY_UPDATED
		 If set, the new callback will be invoked whenever an entry is updated on the calendar.  It  is  implementation  specific  if  the
		 callback function is invoked before or after the specified update type occurs.

   Call Callbacks Extensions (Extension)
       A  pointer to an array of CSA_extension structures for this function.  The array may contain both input extensions for providing additional
       information to the function and output extensions for receiving information from the function.  A value of NULL indicates that  the  caller
       is not using any extensions.  See the extensions structure for more information.

RETURN VALUE
   Call Callbacks Extensions (Extension)
       If  output  extensions were passed to the function in the extensions list, the results from the service will be available in the extension.
       See the extensions structure for more information.  Whether the function succeeded or not, and, if not, why.  It may be success or  one	of
       the values listed under ERRORS below.

ERRORS
       The csa_call_callbacks function returns the following error values:

       CSA_E_FAILURE
		 There was a general failure that does not fit the description of any other error code.

       CSA_E_INSUFFICIENT_MEMORY
		 Insufficient memory was available to complete the requested operation.

       CSA_E_INVALID_FLAG
		 A flag value in the flags argument was invalid.

       CSA_E_INVALID_FUNCTION_EXT
		 The function extension requested is invalid.

       CSA_E_INVALID_PARAMETER
		 A function parameter was invalid.

       CSA_E_INVALID_SESSION_HANDLE
		 The specified Session Handle is invalid or no longer valid (e.g., after logging off).

       CSA_E_NO_AUTHORITY
		 The user has insufficient authority for this function.

       CSA_E_NOT_SUPPORTED
		 The operation requested is not supported by this implementation.

       CSA_E_SERVICE_UNAVAILABLE
		 The requested calendar service is unavailable.

       CSA_E_UNSUPPORTED_FLAG
		 The flag requested is not supported.

       CSA_E_UNSUPPORTED_FUNCTION_EXT
		 The specified function extension is not supported or CSA_EXT_REQUIRED is set.

SEE ALSO
       csa/csa.h    -	 csacsa(5),    csa_add_calendar(3),    csa_add_entry(3),    csa_delete_calendar(3),    csa_delete_entry(3),   csa_free(3),
       csa_free_time_search(3),   csa_list_calendar_attributes(3),   csa_list_calendars(3),   csa_list_entries(3),   csa_list_entry_attributes(3),
       csa_list_entry_sequence(3),   csa_logoff(3),  csa_logon(3),  csa_look_up(3),  csa_query_configuration(3),  csa_read_calendar_attributes(3),
       csa_read_entry_attributes(3),   csa_read_next_reminder(3),    csa_register_callback(3),	  csa_unregister_callback(3),	 csa_update_calen-
       dar_attributes(3), csa_update_entry_attributes(3).

														  csa_call_callbacks(library call)