Administration Functions

Free - Frees memory allocated by the calendaring service.

CSA_return_code
csa_free(
  CSA_buffer      memory
);

List Calendars - Lists the calendars supported by a calendar server.

CSA_return_code
csa_list_calendars(
  CSA_service_reference   calendar_service,
  CSA_uint32              *number_names,
  CSA_calendar_user       **calendar_names,
  CSA_extension           *list_calendars_extensions
);

A host name where the server runs should be passed in calendar_server.

Logon - Logs on to the calendar service and establishes a session with a calendar.

CSA_return_code
csa_logon(
  CSA_service_reference  calendar_service,
  CSA_calendar_user      *user,
  CSA_string             password,
  CSA_string             character_set,
  CSA_string             required_csa_version,
  CSA_session_handle     *session,
  CSA_extension          *logon_extensions
);

Arguments calendar_service, password, character_set, and required_csa_version are not used.

The calendar_address field of the CSA_calendar_user structure pointed to by user specifies the calendar to log onto. The format is calendar@location where calendar is the name of the calendar and location is the host name where the calendar is stored.

The CDE-defined extension CSA_X_DT_GET_USER_ACCESS_EXT is supported. This extension can be used to get the access rights the calling user has with respect to the calendar. The user's access rights is returned in the item_data field of the extension structure.

Logoff - Terminates a session with a calendar.

CSA_return_code
csa_logoff(
  CSA_session_handle     session,
  CSA-extension     *logoff_extensions
);

Query Configuration - Determines information about the installed CSA configuration.

CSA_return_code
csa_query_configuration(
        CSA_session_handle      session,
        CSA_enum                item,
        CSA_buffer              *reference,
        CSA_extension           *query_configuration_extensions
);

The following items are not supported by this implementation of CDE:

CSA_CONFIG_CHARACTER_SET

CSA_CONFIG_LINE_TERM

CSA_CONFIG_VER_IMPLEM