管理関数

この節では、CDE でサポートされる管理関数について説明します。関数のプロトタイプと戻りコードのリストは、各関数に含まれています。詳細は、関連するマニュアル・ページを参照してください。

• 解放 - カレンダ・サービスによって割り当てられたメモリを解放します。

  プロトタイプ

  CSA_return_code
  csa_free(
  CSA_buffer								memory
  );

  csa_free の戻り値

  CSA_SUCCESS  
  CSA_E_INVALID_MEMORY
  

• カレンダのリスト - カレンダ・サーバによってサポートされるカレンダをリストします。

  プロトタイプ

  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);

  サーバが実行されているホスト名が calendar_server に渡されなければなりません。

  csa_list_calendars の戻り値

  CSA_SUCCESS  
  CSA_E_INVALID_PARAMETER   
  CSA_E_UNSUPPORTED_FUNCTION_EXT  
  CSA_E_INSUFFICIENT_MEMORY   
  CSA_X_DT_E_INVALID_SERVER_LOCATION  
  CSA_X_DT_E_SERVICE_NOT_REGISTERED   
  CSA_X_DT_E_SERVER_TIMEOUT   
  CSA_E_FAILURE  
  CSA_E_NOT_SUPPORTED   
  CSA_E_SERVICE_UNAVAILABLE
  

• ログイン - カレンダ・サービスにログインして、カレンダとのセッションを確立します。

  プロトタイプ

  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);

  引き数 calendar_service、password、character_set、および required_csa_version は使用されません。

  user によって指示される CSA_calendar_user 構造体の calendar_address フィールドは、ログインするカレンダを指定します。形式は calendar@location です。calendar はカレンダ名であり、location はカレンダが格納されているホスト名です。

  csa_logon の戻り値

  CSA_SUCCESS  
  CSA_E_INVALID_PARAMETER  
  CSA_E_UNSUPPORTED_FUNCTION_EXT  
  CSA_E_CALENDAR_NOT_EXIST   
  CSA_E_INSUFFICIENT_MEMORY   
  CSA_E_NO_AUTHORITY  
  CSA_X_DT_E_INVALID_SERVER_LOCATION   
  CSA_X_DT_E_SERVICE_NOT_REGISTERED  
  CSA_X_DT_E_SERVER_TIMEOUT   
  CSA_E_FAILURE   
  CSA_E_SERVICE_UNAVAILABLE  
  CSA_X_DT_E_BACKING_STORE_PROBLEM
  

• ログアウト - カレンダとのセッションを終了します。

  プロトタイプ

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

  csa_logoff の戻り値

  CSA_SUCCESS  
  CSA_E_INVALID_PARAMETER   
  CSA_E_UNSUPPORTED_FUNCTION_EXT  
  CSA_E_INSUFFICIENT_MEMORY  
  CSA_E_INVALID_SESSION_HANDLE
  

• 構成の問い合わせ - インストールされた CSA 構成に関する情報を判断します。

  プロトタイプ

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

  CDE では、次の項目はサポートされません。

  CSA_CONFIG_CHARACTER_SET 
  CSA_CONFIG_LINE_TERM  
  CSA_CONFIG_VER_IMPLEM
  

  csa_query_configuration の戻り値

  CSA_SUCCESS  
  CSA_E_INVALID_ENUM   
  CSA_E_INVALID_PARAMETER   
  CSA_E_INSUFFICIENT_MEMORY  
  CSA_E_INVALID_SESSION_HANDLE   
  CSA_E_UNSUPPORTED_ENUM  
  CSA_E_UNSUPPORTED_FUNCTION_EXT