struct E2kSecurityDescriptor

struct E2kSecurityDescriptor {
	GObject parent;

	E2kSecurityDescriptorPrivate *priv;
};

e2k_security_descriptor_new ()

E2kSecurityDescriptor * e2k_security_descriptor_new     (xmlNodePtr xml_form,
                                                         GByteArray *binary_form);

Constructs an E2kSecurityDescriptor from the data in xml_form and binary_form.

e2k_security_descriptor_to_binary ()

GByteArray *        e2k_security_descriptor_to_binary   (E2kSecurityDescriptor *sd);

Converts sd back to binary (E2K_PR_EXCHANGE_SD_BINARY) form so it can be PROPPATCHed back to the server.

e2k_security_descriptor_get_sids ()

GList *             e2k_security_descriptor_get_sids    (E2kSecurityDescriptor *sd);

Returns a GList containing the SIDs of each user or group represented in sd. You can pass these SIDs to e2k_security_descriptor_get_permissions(), e2k_security_descriptor_set_permissions(), and e2k_security_descriptor_remove_sid().

e2k_security_descriptor_get_default ()

E2kSid *            e2k_security_descriptor_get_default (E2kSecurityDescriptor *sd);

Returns an E2kSid corresponding to the default permissions associated with sd. You can pass this to e2k_security_descriptor_get_permissions() and e2k_security_descriptor_set_permissions().

e2k_security_descriptor_remove_sid ()

void                e2k_security_descriptor_remove_sid  (E2kSecurityDescriptor *sd,
                                                         E2kSid *sid);

Removes sid from sd. If sid is a user, this means s/he will now have only the default permissions on sd (unless s/he is a member of a group that is also present in sd.)

enum E2kPermissionsRole

typedef enum {
	E2K_PERMISSIONS_ROLE_OWNER,
	E2K_PERMISSIONS_ROLE_PUBLISHING_EDITOR,
	E2K_PERMISSIONS_ROLE_EDITOR,
	E2K_PERMISSIONS_ROLE_PUBLISHING_AUTHOR,
	E2K_PERMISSIONS_ROLE_AUTHOR,
	E2K_PERMISSIONS_ROLE_NON_EDITING_AUTHOR,
	E2K_PERMISSIONS_ROLE_REVIEWER,
	E2K_PERMISSIONS_ROLE_CONTRIBUTOR,
	E2K_PERMISSIONS_ROLE_NONE,

	E2K_PERMISSIONS_ROLE_NUM_ROLES,
	E2K_PERMISSIONS_ROLE_CUSTOM = -1
} E2kPermissionsRole;

e2k_permissions_role_get_name ()

const gchar *       e2k_permissions_role_get_name       (E2kPermissionsRole role);

Returns the localized name corresponding to role

e2k_permissions_role_get_perms ()

guint32             e2k_permissions_role_get_perms      (E2kPermissionsRole role);

Returns the MAPI permissions associated with role. role may not be E2K_PERMISSIONS_ROLE_CUSTOM.

e2k_permissions_role_find ()

E2kPermissionsRole  e2k_permissions_role_find           (guint perms);

Finds the E2kPermissionsRole value associated with perms. If perms don't describe any standard role, the return value will be E2K_PERMISSIONS_ROLE_CUSTOM

e2k_security_descriptor_get_permissions ()

guint32             e2k_security_descriptor_get_permissions
                                                        (E2kSecurityDescriptor *sd,
                                                         E2kSid *sid);

Computes the MAPI permissions associated with sid. (Only the permissions *directly* associated with sid, not any acquired via group memberships or the Default SID.)

e2k_security_descriptor_set_permissions ()

void                e2k_security_descriptor_set_permissions
                                                        (E2kSecurityDescriptor *sd,
                                                         E2kSid *sid,
                                                         guint32 perms);

Updates or sets sid's permissions on sd.

E2K_PERMISSION_READ_ANY

#define E2K_PERMISSION_READ_ANY         0x001

E2K_PERMISSION_CREATE

#define E2K_PERMISSION_CREATE           0x002

E2K_PERMISSION_EDIT_OWNED

#define E2K_PERMISSION_EDIT_OWNED       0x008

E2K_PERMISSION_DELETE_OWNED

#define E2K_PERMISSION_DELETE_OWNED     0x010

E2K_PERMISSION_EDIT_ANY

#define E2K_PERMISSION_EDIT_ANY         0x020

E2K_PERMISSION_DELETE_ANY

#define E2K_PERMISSION_DELETE_ANY       0x040

E2K_PERMISSION_CREATE_SUBFOLDER

#define E2K_PERMISSION_CREATE_SUBFOLDER 0x080

E2K_PERMISSION_OWNER

#define E2K_PERMISSION_OWNER            0x100

E2K_PERMISSION_CONTACT

#define E2K_PERMISSION_CONTACT          0x200

E2K_PERMISSION_FOLDER_VISIBLE

#define E2K_PERMISSION_FOLDER_VISIBLE   0x400

E2K_PERMISSION_EDIT_MASK

#define E2K_PERMISSION_EDIT_MASK (E2K_PERMISSION_EDIT_ANY | E2K_PERMISSION_EDIT_OWNED)

E2K_PERMISSION_DELETE_MASK

#define E2K_PERMISSION_DELETE_MASK (E2K_PERMISSION_DELETE_ANY | E2K_PERMISSION_DELETE_OWNED)