|  |  |  | Evolution Connector for Microsoft Exchange Programmer’s Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | ||||
E2kAutoconfig; enum E2kExchangeVersion; enum E2kAutoconfigAuthPref; enum E2kAutoconfigResult; E2kAutoconfig * e2k_autoconfig_new (const gchar *owa_uri,const gchar *username,const gchar *password,E2kAutoconfigAuthPref auth_pref); void e2k_autoconfig_free (E2kAutoconfig *ac); void e2k_autoconfig_set_owa_uri (E2kAutoconfig *ac,const gchar *owa_uri); void e2k_autoconfig_set_gc_server (E2kAutoconfig *ac,const gchar *gc_server,gint gal_limit,E2kAutoconfigGalAuthPref gal_auth); void e2k_autoconfig_set_username (E2kAutoconfig *ac,const gchar *username); void e2k_autoconfig_set_password (E2kAutoconfig *ac,const gchar *password); E2kContext * e2k_autoconfig_get_context (E2kAutoconfig *ac,E2kOperation *op,E2kAutoconfigResult *result); E2kAutoconfigResult e2k_autoconfig_check_exchange (E2kAutoconfig *ac,E2kOperation *op); E2kGlobalCatalog * e2k_autoconfig_get_global_catalog (E2kAutoconfig *ac,E2kOperation *op); E2kAutoconfigResult e2k_autoconfig_check_global_catalog (E2kAutoconfig *ac,E2kOperation *op); const gchar * e2k_autoconfig_lookup_option (const gchar *option);
The E2kAutoconfig object handles trying to automatically configure a
user’s account without requiring the user to have to know arcane
details about the organization of the company’s Exchange servers.
typedef struct {
	/* Input data. (gc_server is optional) */
	gchar *owa_uri, *gc_server;
	gchar *username, *password;
	gint gal_limit;
	E2kAutoconfigGalAuthPref gal_auth;
	/* Output data */
	E2kExchangeVersion version;
	gchar *display_name, *email;
	gchar *account_uri, *exchange_server;
	gchar *timezone;
	/* Private-ish members */
	gchar *nt_domain, *w2k_domain;
	gchar *home_uri, *exchange_dn;
	gchar *pf_server;
	E2kAutoconfigAuthPref auth_pref;
	gboolean require_ntlm, use_ntlm;
	gboolean saw_basic, saw_ntlm;
	gboolean nt_domain_defaulted, gc_server_autodetected;
} E2kAutoconfig;
typedef enum {
	E2K_EXCHANGE_UNKNOWN,
	E2K_EXCHANGE_2000,
	E2K_EXCHANGE_2003,
	E2K_EXCHANGE_FUTURE
} E2kExchangeVersion;
typedef enum {
	E2K_AUTOCONFIG_USE_BASIC,
	E2K_AUTOCONFIG_USE_NTLM,
	E2K_AUTOCONFIG_USE_EITHER
} E2kAutoconfigAuthPref;
typedef enum {
	E2K_AUTOCONFIG_OK,
	E2K_AUTOCONFIG_REDIRECT,
	E2K_AUTOCONFIG_TRY_SSL,
	E2K_AUTOCONFIG_AUTH_ERROR,
	E2K_AUTOCONFIG_AUTH_ERROR_TRY_DOMAIN,
	E2K_AUTOCONFIG_AUTH_ERROR_TRY_BASIC,
	E2K_AUTOCONFIG_AUTH_ERROR_TRY_NTLM,
	E2K_AUTOCONFIG_EXCHANGE_5_5,
	E2K_AUTOCONFIG_NOT_EXCHANGE,
	E2K_AUTOCONFIG_NO_OWA,
	E2K_AUTOCONFIG_NO_MAILBOX,
	E2K_AUTOCONFIG_CANT_BPROPFIND,
	E2K_AUTOCONFIG_CANT_RESOLVE,
	E2K_AUTOCONFIG_CANT_CONNECT,
	E2K_AUTOCONFIG_CANCELLED,
	E2K_AUTOCONFIG_FAILED
} E2kAutoconfigResult;
E2kAutoconfig * e2k_autoconfig_new (const gchar *owa_uri,const gchar *username,const gchar *password,E2kAutoconfigAuthPref auth_pref);
Creates an autoconfig context, based on information stored in the config file or provided as arguments.
| 
 | the OWA URI, or NULLto (try to) use a default | 
| 
 | the username (or DOMAIN\username), or NULLto use a default | 
| 
 | the password, or NULLif not yet known | 
| 
 | information about what auth type to use | 
| Returns : | an autoconfig context | 
void                e2k_autoconfig_free                 (E2kAutoconfig *ac);
Frees ac.
| 
 | an autoconfig context | 
void e2k_autoconfig_set_owa_uri (E2kAutoconfig *ac,const gchar *owa_uri);
Sets ac's owa_uri field to owa_uri (or the default if owa_uri is
NULL), and resets any fields whose values had been set based on
the old value of owa_uri.
| 
 | an autoconfig context | 
| 
 | the new OWA URI, or NULL | 
void e2k_autoconfig_set_gc_server (E2kAutoconfig *ac,const gchar *gc_server,gint gal_limit,E2kAutoconfigGalAuthPref gal_auth);
Sets ac's gc_server field to gc_server (or the default if
gc_server is NULL) and the gal_limit field to gal_limit, and
resets any fields whose values had been set based on the old value
of gc_server.
| 
 | an autoconfig context | 
| 
 | the new GC server, or NULL | 
| 
 | GAL search size limit, or -1 for no limit | 
| 
 | Preferred authentication method for gal | 
void e2k_autoconfig_set_username (E2kAutoconfig *ac,const gchar *username);
Sets ac's username field to username (or the default if
username is NULL), and resets any fields whose values had been
set based on the old value of username.
| 
 | an autoconfig context | 
| 
 | the new username (or DOMAIN\username), or NULL | 
void e2k_autoconfig_set_password (E2kAutoconfig *ac,const gchar *password);
Sets or clears ac's password field.
| 
 | an autoconfig context | 
| 
 | the new password, or NULLto clear | 
E2kContext * e2k_autoconfig_get_context (E2kAutoconfig *ac,E2kOperation *op,E2kAutoconfigResult *result);
| 
 | |
| 
 | |
| 
 | |
| Returns : | 
E2kAutoconfigResult e2k_autoconfig_check_exchange (E2kAutoconfig *ac,E2kOperation *op);
| 
 | |
| 
 | |
| Returns : | 
E2kGlobalCatalog * e2k_autoconfig_get_global_catalog (E2kAutoconfig *ac,E2kOperation *op);
Tries to connect to the global catalog associated with ac
(trying to figure it out from the domain name if the server
name is not yet known).
| 
 | an autoconfig context | 
| 
 | an E2kOperation, for cancellation | 
| Returns : | the global catalog, or NULLif the GC server name
wasn't provided and couldn't be autodetected. | 
E2kAutoconfigResult e2k_autoconfig_check_global_catalog (E2kAutoconfig *ac,E2kOperation *op);
| 
 | |
| 
 | |
| Returns : |