Connecting to the Calendar Server

A client can connect to the Calendar server using an already existing [[[ERROR: [NOKX000E] Unable to find definition for key reference 'CCalSession']]]CCalSession. The CCalSession objects can then share the same connection to the server.

You must create a session with the Calendar Server using [[[ERROR: [NOKX000E] Unable to find definition for key reference 'CCalSession']]]CCalSession::NewL() before accessing a calendar entry. This provides a handle to the calendar file and connects you to the Calendar Server.

// Create a session with the Calendar Server from an existing session
CCalSession* CCalSession::NewL(CCalSession& aSessionShared);

You use the same session handle to create other Calendar API objects, such as entry view, category, data exchange, iterator and observers.

The Calendar Server object lets you perform the following functions:

  • create a file using [[[ERROR: [NOKX000E] Unable to find definition for key reference 'CCalSession']]]CCalSession::CreateCalFileL().

    _LIT(KFileName,"D:\\MyCalFile");
    session->CreateCalFileL(KFileName); //pass the descriptor which hold the filename D:\MyCalFile

    Note: If D:\MyCalFile already exists, then the function leaves.

  • open a file using [[[ERROR: [NOKX000E] Unable to find definition for key reference 'CCalSession']]]CCalSession::OpenL().

    _LIT(KFileName,"D:\\MyCalFile");
    session->OpenL(KFileName); //pass the filename D:\MyCalFile to be opened

    Note: The session object must be destroyed only after all the objects which were created by referencing it have been destroyed.

  • list the files in the server using [[[ERROR: [NOKX000E] Unable to find definition for key reference 'CCalSession']]]CCalSession::ListCalFilesL().

  • delete a file using [[[ERROR: [NOKX000E] Unable to find definition for key reference 'CCalSession']]]CCalSession::DeleteCalFileL().