Evolution Connector for Microsoft Exchange Programmer’s Reference Manual | ||||
---|---|---|---|---|
Top | Description |
Synopsis
struct E2kSid; enum E2kSidType; E2kSid * e2k_sid_new_from_string_sid (E2kSidType type
,const gchar *string_sid
,const gchar *display_name
); E2kSid * e2k_sid_new_from_binary_sid (E2kSidType type
,const guint8 *binary_sid
,const gchar *display_name
); #define E2K_SID_WKS_EVERYONE #define E2K_SID_WKS_ANONYMOUS E2kSidType e2k_sid_get_sid_type (E2kSid *sid
); const gchar * e2k_sid_get_string_sid (E2kSid *sid
); const guint8 * e2k_sid_get_binary_sid (E2kSid *sid
); const gchar * e2k_sid_get_display_name (E2kSid *sid
); #define E2K_SID_BINARY_SID_LEN (bsid) guint e2k_sid_binary_sid_hash (gconstpointer key
); gint e2k_sid_binary_sid_equal (gconstpointer a
,gconstpointer b
);
Description
Every user in a Windows domain has a list of Security Identifiers, or SIDs, associated with them. This includes:
their own personal SID
the SID representing “all users in the local domain”
the SID representing “Default”
the SIDs for any Windows security groups that they are members of
The user’s personal SID is stored in the
objectSid
property of their Active Directory entry.
Unfortunately, we have no way of retrieving the complete list of SIDs
associated with a user.
Details
enum E2kSidType
typedef enum { E2K_SID_TYPE_INVALID, E2K_SID_TYPE_USER, E2K_SID_TYPE_ALIAS, E2K_SID_TYPE_GROUP, E2K_SID_TYPE_WELL_KNOWN_GROUP, E2K_SID_TYPE_DOMAIN, E2K_SID_TYPE_DELETED_ACCOUNT, E2K_SID_TYPE_UNKNOWN, E2K_SID_TYPE_COMPUTER } E2kSidType;
e2k_sid_new_from_string_sid ()
E2kSid * e2k_sid_new_from_string_sid (E2kSidType type
,const gchar *string_sid
,const gchar *display_name
);
Creates an E2kSid
from the given information
|
the type of SID that string_sid is
|
|
the string form of a Windows Security Identifier |
|
UTF-8 display name of the user/group/etc identified
by string_sid
|
Returns : |
the new SID |
e2k_sid_new_from_binary_sid ()
E2kSid * e2k_sid_new_from_binary_sid (E2kSidType type
,const guint8 *binary_sid
,const gchar *display_name
);
Creates an E2kSid
from the given information
|
the type of SID that binary_sid is
|
|
the binary form of a Windows Security Identifier |
|
UTF-8 display name of the user/group/etc identified
by string_sid
|
Returns : |
the new SID |
e2k_sid_get_sid_type ()
E2kSidType e2k_sid_get_sid_type (E2kSid *sid
);
Returns the type of sid
(user, group, etc)
|
a SID |
Returns : |
the E2kSidType
|
e2k_sid_get_string_sid ()
const gchar * e2k_sid_get_string_sid (E2kSid *sid
);
Returns the string form of sid
|
a SID |
Returns : |
the string SID |
e2k_sid_get_binary_sid ()
const guint8 * e2k_sid_get_binary_sid (E2kSid *sid
);
Returns the binary form of sid
. Since the SID data is self-delimiting,
no length value is needed. Use E2K_SID_BINARY_SID_LEN()
if you need to
know the size of the binary data.
|
a SID |
Returns : |
the binary SID |
e2k_sid_get_display_name ()
const gchar * e2k_sid_get_display_name (E2kSid *sid
);
Returns the display name of the entity identified by sid
|
a SID |
Returns : |
the UTF-8 display name |
e2k_sid_binary_sid_hash ()
guint e2k_sid_binary_sid_hash (gconstpointer key
);
Hashes key
, a binary SID. For use with GHashTable.
|
pointer to a binary SID |
Returns : |
the hash value |