csa_add_calendar(library call)			csa_add_calendar(library call)

NAME
       csa_add_calendar — add a calendar to the calendar service

SYNOPSIS
       #include <xcsa.h>
       CSA_return_code csa_add_calendar(
       CSA_session_handle session,
       CSA_calendar_user *user,
       CSA_uint32 number_attributes,
       CSA_attribute *calendar_attributes,
       CSA_extension *add_calendar_extensions);

DESCRIPTION
       The  csa_add_calendar  function creates a calendar on the calendar ser‐
       vice.  If the user does not have sufficient authority to add a calendar
       to  the service, the error CSA_E_NO_AUTHORITY is returned.  If the cal‐
       endar already exists the error CSA_E_CALENDAR_EXISTS is returned.

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

       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_SESSION_HANDLE is returned.  The session handle
       may be NULL if the calendar service does not require a  session	to  be
       established in order to add a calendar.

   User (Calendar User)
       A  pointer  to  a calendar user structure.  This specifies the user and
       name of the calendar to be added to the calendar service.

   Number Attributes (Uint32)
       The number of elements in calendar_attributes argument.

   Calendar Attributes (Attributes)
       A pointer to an array of attribute structures that specify the calendar
       attributes for the new calendar.

   Add CalendarExtensions (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 infor‐
       mation from the function.  A value of NULL indicates that the caller is
       not using any extensions.  See the extensions structure for more infor‐
       mation.

RETURN VALUE
   Add Calendar 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	 func‐
       tion  succeeded	or not, and, if not, why.  It may be success or one of
       the values listed under ERRORS below.

ERRORS
       The csa_add_calendar function returns the following error values:

       CSA_E_CALENDAR_EXISTS
		 The specified calendar already exists.

       CSA_E_DISK_FULL
		 Insufficient  disk  space  was	 available  to	complete   the
		 requested  operation  (this may refer to local or shared disk
		 space).

       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_ATTRIBUTE
		 An attribute was specified that was not defined by this spec‐
		 ification   and  the  implementation  does  not  support  the
		 attribute as an application specific attribute.

       CSA_E_INVALID_ATTRIBUTE_VALUE
		 An invalid attribute value was specified for an attribute.

       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_INAVLID_SESSION_HANDLE

       CSA_E_INVALID_USER
		 The specified calendar user is invalid.

       CSA_E_NO_AUTHORITY
		 The user has insufficient authority for this function.

       CSA_E_NOT_SUPPORTED
		 The operation requested is not supported by this  implementa‐
		 tion.

       CSA_E_READONLY

       CSA_E_SERVICE_UNAVAILABLE
		 The requested calendar service is unavailable.

       CSA_E_TEXT_TOO_LARGE
		 The  size  of the text string passed to the implementation is
		 too large.

       CSA_E_UNSUPPORTED_ATTRIBUTE
		 An attribute was encountered that is unsupported by the  cal‐
		 endar service.

       CSA_E_UNSUPPORTED_CHARACTER_SET
		 The character set requested is not supported.

       CSA_E_UNSUPPORTED_DATA_EXT
		 The data extension requested is not supported.

       CSA_E_UNSUPPORTED_ENUM
		 The specified enumerated value is not valid.

       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_entry(3),	csa_call_callbacks(3),
       csa_delete_calendar(3),	      csa_delete_entry(3),	  csa_free(3),
       csa_free_time_search(3), csa_list_calendar_attributes(3), csa_list_cal‐
       endars(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_calen‐
       dar_attributes(3),			 csa_read_entry_attributes(3),
       csa_read_next_reminder(3),    csa_register_callback(3),	  csa_unregis‐
       ter_callback(3),			    csa_update_calendar_attributes(3),
       csa_update_entry_attributes(3).

						csa_add_calendar(library call)

Vote for polarhome