enum EimIdType {
EIM_UNIQUE_NAME,
EIM_ENTRY_UUID,
EIM_NAME
};
typedef struct EimIdentifierInfo
{
union {
char * uniqueName;
char * entryUUID;
char * name;
} id;
enum EimIdType idtype;
} EimIdentifierInfo;
idtype will indicate which identifier name has been provided. There is no guarantee that name will find a unique identifier. Therefore, use of name may result in multiple identifiers being returned. The id values, uniqueName, entryUUID and name may contain the wild card (*).
The EimList structure contains information about the returned data. The API will return as much data as space has been provided. The data returned is a linked list of EimIdentifier structures. firstEntry is used to get to the first EimIdentifier structure in the linked list.
EimList structure:
typedef struct EimList
{
unsigned int bytesReturned; /* Number of bytes actually returned
by the API */
unsigned int bytesAvailable; /* Number of bytes of available data
that could have been returned by
the API */
unsigned int entriesReturned; /* Number of entries actually
returned by the API */
unsigned int entriesAvailable; /* Number of entries available to be
returned by the API */
unsigned int firstEntry; /* Displacement to the first linked
list entry. This byte offset is
relative to the start of the
EimList structure. */
} EimList;
EimIdentifier structure:
typedef struct EimIdentifier
{
unsigned int nextEntry; /* Displacement to next entry. This
byte offset is relative to the
start of this structure */
EimListData uniquename; /* Unique name */
EimListData description; /* Description */
EimListData entryUUID; /* UUID */
EimSubList names; /* EimIdentifierName sublist */
EimSubList additionalInfo; /* EimAddlInfo sublist */
enum EimAssociationType type; /* Association type - not valid */
EimListData groupRegistry; /* Group registry - not valid */
} EimIdentifier;
Identifiers may have several name attributes as well as several additional information attributes. In the EimIdentifier structure, the names EimSubList gives addressability to a linked list of EimIdentifierName structures.
EimIdentifierName structure:
typedef struct EimIdentifierName
{
unsigned int nextEntry; /* Displacement to next entry. This
byte offset is relative to the
start of this structure */
EimListData name; /* Name */
} EimIdentifierName;
The additionalInfo EimSubList gives addressability to a linked list of EimAddlInfo structures.
EimAddlInfo structure:
typedef struct EimAddlInfo
{
unsigned int nextEntry; /* Displacement to next entry. This
byte offset is relative to the
start of this structure */
EimListData addlInfo; /* Additional info */
} EimAddlInfo;
EimSubList structure:
typedef struct EimSubList
{
unsigned int listNum; /* Number of entries in the list */
unsigned int disp; /* Displacement to sublist. This
byte offset is relative to the
start of the parent structure;
that is, the structure containing
this structure. */
} EimSubList;
EimListData structure:
typedef struct EimListData
{
unsigned int length; /* Length of data */
unsigned int disp; /* Displacement to data. This byte
offset is relative to the start of
the parent structure; that is, the
structure containing this
structure. */
} EimListData;