General Information About Functions

The following general information applies to all functions:

• Character set restriction

  The calendar attribute, CSA_CAL_ATTR_CHARACTER_SET, is used to store the locale information of the calendar.

All data except textual description passed in the library must be in ASCII format; the library supports single-byte as well as multibyte character strings.

• Type checking for attribute values is provided for the predefined attributes only.

• Entry attributes CSA_ENTRY_ATTR_RECURRENCE_RULE and CSA_ENTRY_ATTR_EXCEPTION_DATES are used to specify recurrence information of a calendar entry. Information in the CSA_ENTRY_ATTR_RECURRENCE_RULE attribute can be queried using the following attributes:

  CSA_X_DT_ENTRY_ATTR_REPEAT_TYPE  
  CSA_X_DT_ENTRY_ATTR_REPEAT_TIMES  
  CSA_X_DT_ENTRY_ATTR_REPEAT_INTERVAL  
  CSA_X_DT_ENTRY_ATTR_REPEAT_OCCURRENCE_NUM  
  CSA_X_DT_ENTRY_ATTR_SEQUENCE_END_DATE. 

  These computed attributes are read-only.

• The CSA_calendar_user data structure specifies either a user or a calendar. When specifying a user in an access list, only the user_name field is used and all other fields are ignored. When specifying the calendar to log on to, only the calendar_address field is used and all other fields are ignored. The format is calendar@location where calendar is the name of the calendar and location is the name of the machine where the calendar is stored.

• Attributes of value type CSA_VALUE_ATTENDEE_LIST are not supported and CSA_E_INVALID_ATTRIBUTE_VALUE will be returned if they are specified.

• Although the repeat_count and snooze_time fields in the CSA_reminder data structure are stored in the calendar, the calendar service does not interpret their values and the associated reminder will be returned only once by the server.

• The user interface extension CSA_X_UI_ID_EXT is not supported.

Function Extensions Supported

• Xt Application Context Extension (CSA_X_XT_APP_CONTEXT_EXT)

  - Specify the Xt application context. - Used by csa_register_callback()- Input:

  item_data: Xt application context (XtAppContext)

  - Output: None

• Get User Access Extension (CSA_X_DT_GET_USER_ACCESS_EXT)

  - Get the user's access rights with respect to the calendar. - Used by csa_logon()- Input: none - Output:

  item_data: user's access rights (CSA_flags)

• Get Character Set Calendar Attribute Extension (CSA_X_DT_GET_CAL_CHARSET_EXT)

  - Get the calendar's character set attribute - Used by csa_logon() ()- Input: none - Output:

  item_data: length of character string in item_reference (CSA_uint32) item_reference: character set (CSA_string)

• Get Server Version Calendar Attribute Extension (CSA_X_DT_GET_SERVER_VERSION_EXT)

  - Get server version of the calendar - Used by csa_logon() and csa_list_calendars()- Input: none - Output:

  item_data: server version (CSA_uint32)

• Get Data Version Calendar Attribute Extension (CSA_X_DT_GET_DATA_VERSION_EXT)

  - Get data version of the calendar - Used by csa_logon() ()- Input: none - Output:

  item_data: data version (CSA_uint32)