Evolution Connector for Microsoft Exchange Programmer’s Reference Manual | ||||
---|---|---|---|---|
Top | Description |
Synopsis
E2kFreebusy; enum E2kBusyStatus; E2kFreebusyEvent; E2kFreebusy * e2k_freebusy_new (E2kContext *ctx
,const gchar *public_uri
,const gchar *dn
); void e2k_freebusy_reset (E2kFreebusy *fb
,gint nmonths
); void e2k_freebusy_add_interval (E2kFreebusy *fb
,E2kBusyStatus busystatus
,time_t start
,time_t end
); void e2k_freebusy_clear_interval (E2kFreebusy *fb
,time_t start
,time_t end
); E2kHTTPStatus e2k_freebusy_add_from_calendar_uri (E2kFreebusy *fb
,const gchar *uri
,time_t start_tt
,time_t end_tt
); E2kHTTPStatus e2k_freebusy_save (E2kFreebusy *fb
); void e2k_freebusy_destroy (E2kFreebusy *fb
);
Details
enum E2kBusyStatus
typedef enum { E2K_BUSYSTATUS_FREE = 0, E2K_BUSYSTATUS_TENTATIVE = 1, E2K_BUSYSTATUS_BUSY = 2, E2K_BUSYSTATUS_OOF = 3, E2K_BUSYSTATUS_MAX, /* Alias for internal use */ E2K_BUSYSTATUS_ALL = E2K_BUSYSTATUS_FREE } E2kBusyStatus;
e2k_freebusy_new ()
E2kFreebusy * e2k_freebusy_new (E2kContext *ctx
,const gchar *public_uri
,const gchar *dn
);
Creates a new E2kFreebusy, filled in with information from the
indicated user's published free/busy information. This uses the
public free/busy folder; the caller does not need permission to
access the dn
's Calendar.
Note that currently, this will fail and return NULL
if the user
does not already have free/busy information stored on the server.
|
an E2kContext |
|
the URI of the MAPI public folder tree |
|
the legacy Exchange DN of a user |
Returns : |
the freebusy information |
e2k_freebusy_reset ()
void e2k_freebusy_reset (E2kFreebusy *fb
,gint nmonths
);
Clears all existing data in fb
and resets the start and end times
to a span of nmonths
around the current date.
|
an E2kFreebusy |
|
the number of months of info fb will store
|
e2k_freebusy_add_interval ()
void e2k_freebusy_add_interval (E2kFreebusy *fb
,E2kBusyStatus busystatus
,time_t start
,time_t end
);
This adds an interval of type busystatus
to fb
.
|
an E2kFreebusy |
|
the busy status of the interval |
|
the start of the interval |
|
the end of the interval |
e2k_freebusy_clear_interval ()
void e2k_freebusy_clear_interval (E2kFreebusy *fb
,time_t start
,time_t end
);
This removes any events between start
and end
in fb
.
|
an E2kFreebusy |
|
the start of the interval |
|
the end of the interval |
e2k_freebusy_add_from_calendar_uri ()
E2kHTTPStatus e2k_freebusy_add_from_calendar_uri (E2kFreebusy *fb
,const gchar *uri
,time_t start_tt
,time_t end_tt
);
This queries the server for events between start_tt
and end_tt
in
the calendar at uri
(which the caller must have permission to
read) and adds them fb
. Any previously-existing events during that
range are removed.
|
an E2kFreebusy |
|
the URI of a calendar folder |
|
start of the range to add |
|
end of the range to add |
Returns : |
an HTTP status code. |
e2k_freebusy_save ()
E2kHTTPStatus e2k_freebusy_save (E2kFreebusy *fb
);
Saves the data in fb
back to the server.
|
an E2kFreebusy |
Returns : |
a libsoup or HTTP status code |
e2k_freebusy_destroy ()
void e2k_freebusy_destroy (E2kFreebusy *fb
);
Frees fb
and all associated data.
|
the E2kFreebusy |