\hypertarget{mw__st__list_8h}{
\section{mw\_\-st\_\-list.h File Reference}
\label{mw__st__list_8h}\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}}
}


\subsection{Detailed Description}
Parse and compose buddy lists in the format commonly used by Sametime Connect clients. 



{\tt \#include $<$glib.h$>$}\par
{\tt \#include $<$glib/glist.h$>$}\par
{\tt \#include \char`\"{}mw\_\-common.h\char`\"{}}\par
\subsection*{Defines}
\begin{CompactItemize}
\item 
\#define \hyperlink{mw__st__list_8h_715e847e70de42700c2c0c1d33d5f771}{ST\_\-LIST\_\-MAJOR}~3
\item 
\#define \hyperlink{mw__st__list_8h_de9021794a873b0860b9875b417e5088}{ST\_\-LIST\_\-MICRO}~3
\item 
\#define \hyperlink{mw__st__list_8h_ff9d92721785a9ec3af6142361abfb40}{ST\_\-LIST\_\-MINOR}~1
\end{CompactItemize}
\subsection*{Enumerations}
\begin{CompactItemize}
\item 
enum \hyperlink{mw__st__list_8h_e7a7eada1fbfba224c91e3bf024c4a80}{mwSametimeGroupType} \{ \par
\hyperlink{mw__st__list_8h_e7a7eada1fbfba224c91e3bf024c4a8004914e2397b4a83eb46f8cdb5beee2ca}{mwSametimeGroup\_\-NORMAL} =  1, 
\par
\hyperlink{mw__st__list_8h_e7a7eada1fbfba224c91e3bf024c4a80e96fc4dd1780f6107afcd1fb70c373fb}{mwSametimeGroup\_\-DYNAMIC} =  2, 
\par
\hyperlink{mw__st__list_8h_e7a7eada1fbfba224c91e3bf024c4a80d301d994bb64a2b0bb25b59b40439371}{mwSametimeGroup\_\-UNKNOWN} =  0
 \}
\item 
enum \hyperlink{mw__st__list_8h_eea8d986216fa5352ef35fd07e4859cf}{mwSametimeUserType} \{ \par
\hyperlink{mw__st__list_8h_eea8d986216fa5352ef35fd07e4859cf4bc8362167b87cc1380e542371715262}{mwSametimeUser\_\-NORMAL} =  1, 
\par
\hyperlink{mw__st__list_8h_eea8d986216fa5352ef35fd07e4859cf39672058ac7d4dc639de70b52409c551}{mwSametimeUser\_\-EXTERNAL} =  2, 
\par
\hyperlink{mw__st__list_8h_eea8d986216fa5352ef35fd07e4859cf9f5fd5999785f3e37dc5c51fec2b2143}{mwSametimeUser\_\-UNKNOWN} =  0
 \}
\end{CompactItemize}
\subsection*{Functions}
\begin{CompactItemize}
\item 
struct \hyperlink{structmwSametimeUser}{mwSametimeUser} $\ast$ \hyperlink{mw__st__list_8h_887adb5f00aef0c75c4f98e296bce88e}{mwSametimeGroup\_\-findUser} (struct \hyperlink{structmwSametimeGroup}{mwSametimeGroup} $\ast$g, struct \hyperlink{structmwIdBlock}{mwIdBlock} $\ast$user)
\item 
void \hyperlink{mw__st__list_8h_313ca7ef6c6229de0f16721318a47ff2}{mwSametimeGroup\_\-free} (struct \hyperlink{structmwSametimeGroup}{mwSametimeGroup} $\ast$g)
\begin{CompactList}\small\item\em Remove a group from its list, and free it. \item\end{CompactList}\item 
const char $\ast$ \hyperlink{mw__st__list_8h_abccae5ef3c58d9488035ba1495d62fc}{mwSametimeGroup\_\-getAlias} (struct \hyperlink{structmwSametimeGroup}{mwSametimeGroup} $\ast$g)
\item 
struct \hyperlink{structmwSametimeList}{mwSametimeList} $\ast$ \hyperlink{mw__st__list_8h_bb1234b841c396d1f5345062dcf8cb81}{mwSametimeGroup\_\-getList} (struct \hyperlink{structmwSametimeGroup}{mwSametimeGroup} $\ast$g)
\item 
const char $\ast$ \hyperlink{mw__st__list_8h_296847bebae85dbc835e711cd0e9637c}{mwSametimeGroup\_\-getName} (struct \hyperlink{structmwSametimeGroup}{mwSametimeGroup} $\ast$g)
\item 
enum \hyperlink{mw__st__list_8h_e7a7eada1fbfba224c91e3bf024c4a80}{mwSametimeGroupType} \hyperlink{mw__st__list_8h_1c9eb0f2f666416d6ecd91c5107a7b05}{mwSametimeGroup\_\-getType} (struct \hyperlink{structmwSametimeGroup}{mwSametimeGroup} $\ast$g)
\item 
GList $\ast$ \hyperlink{mw__st__list_8h_956dcc093ff8aef0a0d79cf412be424a}{mwSametimeGroup\_\-getUsers} (struct \hyperlink{structmwSametimeGroup}{mwSametimeGroup} $\ast$g)
\begin{CompactList}\small\item\em Get a GList snapshot of the users in a list. \item\end{CompactList}\item 
gboolean \hyperlink{mw__st__list_8h_f60b92182c95f3110bc088bec3fdf82d}{mwSametimeGroup\_\-isOpen} (struct \hyperlink{structmwSametimeGroup}{mwSametimeGroup} $\ast$g)
\item 
struct \hyperlink{structmwSametimeGroup}{mwSametimeGroup} $\ast$ \hyperlink{mw__st__list_8h_5cbae1e76333389ea7972d0155ad92a3}{mwSametimeGroup\_\-new} (struct \hyperlink{structmwSametimeList}{mwSametimeList} $\ast$l, enum \hyperlink{mw__st__list_8h_e7a7eada1fbfba224c91e3bf024c4a80}{mwSametimeGroupType} type, const char $\ast$name)
\begin{CompactList}\small\item\em Create a new group in a list. \item\end{CompactList}\item 
void \hyperlink{mw__st__list_8h_61c6c15ef09d6622fe9aeb8d8af65dea}{mwSametimeGroup\_\-setAlias} (struct \hyperlink{structmwSametimeGroup}{mwSametimeGroup} $\ast$g, const char $\ast$alias)
\item 
void \hyperlink{mw__st__list_8h_a9f4dc8cea4b7fcdb17edfe52117e59e}{mwSametimeGroup\_\-setOpen} (struct \hyperlink{structmwSametimeGroup}{mwSametimeGroup} $\ast$g, gboolean open)
\item 
struct \hyperlink{structmwSametimeGroup}{mwSametimeGroup} $\ast$ \hyperlink{mw__st__list_8h_9459fb70bdb908c29dcf60b71552a403}{mwSametimeList\_\-findGroup} (struct \hyperlink{structmwSametimeList}{mwSametimeList} $\ast$l, const char $\ast$name)
\item 
void \hyperlink{mw__st__list_8h_24b6daf1da8c15b9e7ca5d11a97c974c}{mwSametimeList\_\-free} (struct \hyperlink{structmwSametimeList}{mwSametimeList} $\ast$l)
\begin{CompactList}\small\item\em Free the list, all of its groups, and all of the groups' members. \item\end{CompactList}\item 
void \hyperlink{mw__st__list_8h_86df0bcac8db117ae3358158d3482ae2}{mwSametimeList\_\-get} (struct \hyperlink{structmwGetBuffer}{mwGetBuffer} $\ast$b, struct \hyperlink{structmwSametimeList}{mwSametimeList} $\ast$l)
\begin{CompactList}\small\item\em Load a sametime list from a buffer. \item\end{CompactList}\item 
GList $\ast$ \hyperlink{mw__st__list_8h_cb7f427294efab1b150e4311a6a30013}{mwSametimeList\_\-getGroups} (struct \hyperlink{structmwSametimeList}{mwSametimeList} $\ast$l)
\begin{CompactList}\small\item\em Get a GList snapshot of the groups in a list. \item\end{CompactList}\item 
guint \hyperlink{mw__st__list_8h_3d0310433c25fba86ee008f6272403d1}{mwSametimeList\_\-getMajor} (struct \hyperlink{structmwSametimeList}{mwSametimeList} $\ast$l)
\item 
guint \hyperlink{mw__st__list_8h_68042bfba90ce27b4f983d98cc86edb9}{mwSametimeList\_\-getMicro} (struct \hyperlink{structmwSametimeList}{mwSametimeList} $\ast$l)
\item 
guint \hyperlink{mw__st__list_8h_8789726403941fb31b42f00010b0180f}{mwSametimeList\_\-getMinor} (struct \hyperlink{structmwSametimeList}{mwSametimeList} $\ast$l)
\item 
struct \hyperlink{structmwSametimeList}{mwSametimeList} $\ast$ \hyperlink{mw__st__list_8h_6ed7fd6968c4d921351311c707f3cabf}{mwSametimeList\_\-load} (const char $\ast$str)
\begin{CompactList}\small\item\em convert a plain string into a sametime list \item\end{CompactList}\item 
struct \hyperlink{structmwSametimeList}{mwSametimeList} $\ast$ \hyperlink{mw__st__list_8h_edd802ae26018b96aa30a9d84b8e2bfe}{mwSametimeList\_\-new} ()
\begin{CompactList}\small\item\em Create a new list. \item\end{CompactList}\item 
void \hyperlink{mw__st__list_8h_146ddcf9a0cb7f89cac27e82accc2c6f}{mwSametimeList\_\-put} (struct \hyperlink{structmwPutBuffer}{mwPutBuffer} $\ast$b, struct \hyperlink{structmwSametimeList}{mwSametimeList} $\ast$l)
\begin{CompactList}\small\item\em Write a sametime list onto a buffer. \item\end{CompactList}\item 
void \hyperlink{mw__st__list_8h_97d9e5598c71ca1b8c495059f5ce1139}{mwSametimeList\_\-setMajor} (struct \hyperlink{structmwSametimeList}{mwSametimeList} $\ast$l, guint v)
\item 
void \hyperlink{mw__st__list_8h_8851984da5f2eea7b503b84f74aded24}{mwSametimeList\_\-setMicro} (struct \hyperlink{structmwSametimeList}{mwSametimeList} $\ast$l, guint v)
\item 
void \hyperlink{mw__st__list_8h_818f2b470246cc12237855ca1abe3d02}{mwSametimeList\_\-setMinor} (struct \hyperlink{structmwSametimeList}{mwSametimeList} $\ast$l, guint v)
\item 
char $\ast$ \hyperlink{mw__st__list_8h_bf3a05001e8b9fb74447c9c7c987a895}{mwSametimeList\_\-store} (struct \hyperlink{structmwSametimeList}{mwSametimeList} $\ast$l)
\begin{CompactList}\small\item\em convert a sametime list into a string \item\end{CompactList}\item 
void \hyperlink{mw__st__list_8h_3e34c3302305e147d975e278eddd62ce}{mwSametimeUser\_\-free} (struct \hyperlink{structmwSametimeUser}{mwSametimeUser} $\ast$u)
\begin{CompactList}\small\item\em Remove user from its group, and free it. \item\end{CompactList}\item 
const char $\ast$ \hyperlink{mw__st__list_8h_1ad661addb3d5d735e4c22492bf4e40b}{mwSametimeUser\_\-getAlias} (struct \hyperlink{structmwSametimeUser}{mwSametimeUser} $\ast$u)
\item 
const char $\ast$ \hyperlink{mw__st__list_8h_aa3d6dfc4853603a4306ef9d35a3fdac}{mwSametimeUser\_\-getCommunity} (struct \hyperlink{structmwSametimeUser}{mwSametimeUser} $\ast$u)
\item 
struct \hyperlink{structmwSametimeGroup}{mwSametimeGroup} $\ast$ \hyperlink{mw__st__list_8h_d6365cdf88668606b45d7485ea0aa644}{mwSametimeUser\_\-getGroup} (struct \hyperlink{structmwSametimeUser}{mwSametimeUser} $\ast$u)
\item 
const char $\ast$ \hyperlink{mw__st__list_8h_2d90874d7d520a876ec31992e3f2ea9f}{mwSametimeUser\_\-getShortName} (struct \hyperlink{structmwSametimeUser}{mwSametimeUser} $\ast$u)
\item 
enum \hyperlink{mw__st__list_8h_eea8d986216fa5352ef35fd07e4859cf}{mwSametimeUserType} \hyperlink{mw__st__list_8h_56588fb0e8373b5275b4140a61b3621b}{mwSametimeUser\_\-getType} (struct \hyperlink{structmwSametimeUser}{mwSametimeUser} $\ast$u)
\item 
const char $\ast$ \hyperlink{mw__st__list_8h_0ba53c8c6bffc70ebb04cd62c89f8186}{mwSametimeUser\_\-getUser} (struct \hyperlink{structmwSametimeUser}{mwSametimeUser} $\ast$u)
\item 
struct \hyperlink{structmwSametimeUser}{mwSametimeUser} $\ast$ \hyperlink{mw__st__list_8h_b1cc894d9c0903db2b9de07a126dc6e6}{mwSametimeUser\_\-new} (struct \hyperlink{structmwSametimeGroup}{mwSametimeGroup} $\ast$g, enum \hyperlink{mw__st__list_8h_eea8d986216fa5352ef35fd07e4859cf}{mwSametimeUserType} type, struct \hyperlink{structmwIdBlock}{mwIdBlock} $\ast$user)
\begin{CompactList}\small\item\em Create a user in a group. \item\end{CompactList}\item 
void \hyperlink{mw__st__list_8h_f49e9faa2568d3feb02dbb5ca3c034b1}{mwSametimeUser\_\-setAlias} (struct \hyperlink{structmwSametimeUser}{mwSametimeUser} $\ast$u, const char $\ast$alias)
\item 
void \hyperlink{mw__st__list_8h_13f35f7da41c009ae5045f26678b4d78}{mwSametimeUser\_\-setShortName} (struct \hyperlink{structmwSametimeUser}{mwSametimeUser} $\ast$u, const char $\ast$name)
\end{CompactItemize}


\subsection{Define Documentation}
\hypertarget{mw__st__list_8h_715e847e70de42700c2c0c1d33d5f771}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!ST\_\-LIST\_\-MAJOR@{ST\_\-LIST\_\-MAJOR}}
\index{ST\_\-LIST\_\-MAJOR@{ST\_\-LIST\_\-MAJOR}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}\#define ST\_\-LIST\_\-MAJOR~3}}
\label{mw__st__list_8h_715e847e70de42700c2c0c1d33d5f771}


\hypertarget{mw__st__list_8h_de9021794a873b0860b9875b417e5088}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!ST\_\-LIST\_\-MICRO@{ST\_\-LIST\_\-MICRO}}
\index{ST\_\-LIST\_\-MICRO@{ST\_\-LIST\_\-MICRO}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}\#define ST\_\-LIST\_\-MICRO~3}}
\label{mw__st__list_8h_de9021794a873b0860b9875b417e5088}


\hypertarget{mw__st__list_8h_ff9d92721785a9ec3af6142361abfb40}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!ST\_\-LIST\_\-MINOR@{ST\_\-LIST\_\-MINOR}}
\index{ST\_\-LIST\_\-MINOR@{ST\_\-LIST\_\-MINOR}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}\#define ST\_\-LIST\_\-MINOR~1}}
\label{mw__st__list_8h_ff9d92721785a9ec3af6142361abfb40}




\subsection{Enumeration Type Documentation}
\hypertarget{mw__st__list_8h_e7a7eada1fbfba224c91e3bf024c4a80}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeGroupType@{mwSametimeGroupType}}
\index{mwSametimeGroupType@{mwSametimeGroupType}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf mwSametimeGroupType}}}
\label{mw__st__list_8h_e7a7eada1fbfba224c91e3bf024c4a80}


\begin{Desc}
\item[Enumerator: ]\par
\begin{description}
\index{mwSametimeGroup\_\-NORMAL@{mwSametimeGroup\_\-NORMAL}!mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}}\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeGroup\_\-NORMAL@{mwSametimeGroup\_\-NORMAL}}\item[{\em 
\hypertarget{mw__st__list_8h_e7a7eada1fbfba224c91e3bf024c4a8004914e2397b4a83eb46f8cdb5beee2ca}{
mwSametimeGroup\_\-NORMAL}
\label{mw__st__list_8h_e7a7eada1fbfba224c91e3bf024c4a8004914e2397b4a83eb46f8cdb5beee2ca}
}]a normal group of users \index{mwSametimeGroup\_\-DYNAMIC@{mwSametimeGroup\_\-DYNAMIC}!mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}}\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeGroup\_\-DYNAMIC@{mwSametimeGroup\_\-DYNAMIC}}\item[{\em 
\hypertarget{mw__st__list_8h_e7a7eada1fbfba224c91e3bf024c4a80e96fc4dd1780f6107afcd1fb70c373fb}{
mwSametimeGroup\_\-DYNAMIC}
\label{mw__st__list_8h_e7a7eada1fbfba224c91e3bf024c4a80e96fc4dd1780f6107afcd1fb70c373fb}
}]a server-side group \index{mwSametimeGroup\_\-UNKNOWN@{mwSametimeGroup\_\-UNKNOWN}!mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}}\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeGroup\_\-UNKNOWN@{mwSametimeGroup\_\-UNKNOWN}}\item[{\em 
\hypertarget{mw__st__list_8h_e7a7eada1fbfba224c91e3bf024c4a80d301d994bb64a2b0bb25b59b40439371}{
mwSametimeGroup\_\-UNKNOWN}
\label{mw__st__list_8h_e7a7eada1fbfba224c91e3bf024c4a80d301d994bb64a2b0bb25b59b40439371}
}]error determining group type \end{description}
\end{Desc}

\hypertarget{mw__st__list_8h_eea8d986216fa5352ef35fd07e4859cf}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeUserType@{mwSametimeUserType}}
\index{mwSametimeUserType@{mwSametimeUserType}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf mwSametimeUserType}}}
\label{mw__st__list_8h_eea8d986216fa5352ef35fd07e4859cf}


\begin{Desc}
\item[Enumerator: ]\par
\begin{description}
\index{mwSametimeUser\_\-NORMAL@{mwSametimeUser\_\-NORMAL}!mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}}\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeUser\_\-NORMAL@{mwSametimeUser\_\-NORMAL}}\item[{\em 
\hypertarget{mw__st__list_8h_eea8d986216fa5352ef35fd07e4859cf4bc8362167b87cc1380e542371715262}{
mwSametimeUser\_\-NORMAL}
\label{mw__st__list_8h_eea8d986216fa5352ef35fd07e4859cf4bc8362167b87cc1380e542371715262}
}]user on same community \index{mwSametimeUser\_\-EXTERNAL@{mwSametimeUser\_\-EXTERNAL}!mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}}\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeUser\_\-EXTERNAL@{mwSametimeUser\_\-EXTERNAL}}\item[{\em 
\hypertarget{mw__st__list_8h_eea8d986216fa5352ef35fd07e4859cf39672058ac7d4dc639de70b52409c551}{
mwSametimeUser\_\-EXTERNAL}
\label{mw__st__list_8h_eea8d986216fa5352ef35fd07e4859cf39672058ac7d4dc639de70b52409c551}
}]external user \index{mwSametimeUser\_\-UNKNOWN@{mwSametimeUser\_\-UNKNOWN}!mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}}\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeUser\_\-UNKNOWN@{mwSametimeUser\_\-UNKNOWN}}\item[{\em 
\hypertarget{mw__st__list_8h_eea8d986216fa5352ef35fd07e4859cf9f5fd5999785f3e37dc5c51fec2b2143}{
mwSametimeUser\_\-UNKNOWN}
\label{mw__st__list_8h_eea8d986216fa5352ef35fd07e4859cf9f5fd5999785f3e37dc5c51fec2b2143}
}]error determining user type \end{description}
\end{Desc}



\subsection{Function Documentation}
\hypertarget{mw__st__list_8h_887adb5f00aef0c75c4f98e296bce88e}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeGroup\_\-findUser@{mwSametimeGroup\_\-findUser}}
\index{mwSametimeGroup\_\-findUser@{mwSametimeGroup\_\-findUser}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}struct {\bf mwSametimeUser}$\ast$ mwSametimeGroup\_\-findUser (struct {\bf mwSametimeGroup} $\ast$ {\em g}, \/  struct {\bf mwIdBlock} $\ast$ {\em user})\hspace{0.3cm}{\tt  \mbox{[}read\mbox{]}}}}
\label{mw__st__list_8h_887adb5f00aef0c75c4f98e296bce88e}


\hypertarget{mw__st__list_8h_313ca7ef6c6229de0f16721318a47ff2}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeGroup\_\-free@{mwSametimeGroup\_\-free}}
\index{mwSametimeGroup\_\-free@{mwSametimeGroup\_\-free}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void mwSametimeGroup\_\-free (struct {\bf mwSametimeGroup} $\ast$ {\em g})}}
\label{mw__st__list_8h_313ca7ef6c6229de0f16721318a47ff2}


Remove a group from its list, and free it. 

Also frees all users contained in the group \hypertarget{mw__st__list_8h_abccae5ef3c58d9488035ba1495d62fc}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeGroup\_\-getAlias@{mwSametimeGroup\_\-getAlias}}
\index{mwSametimeGroup\_\-getAlias@{mwSametimeGroup\_\-getAlias}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$ mwSametimeGroup\_\-getAlias (struct {\bf mwSametimeGroup} $\ast$ {\em g})}}
\label{mw__st__list_8h_abccae5ef3c58d9488035ba1495d62fc}


\hypertarget{mw__st__list_8h_bb1234b841c396d1f5345062dcf8cb81}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeGroup\_\-getList@{mwSametimeGroup\_\-getList}}
\index{mwSametimeGroup\_\-getList@{mwSametimeGroup\_\-getList}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}struct {\bf mwSametimeList}$\ast$ mwSametimeGroup\_\-getList (struct {\bf mwSametimeGroup} $\ast$ {\em g})\hspace{0.3cm}{\tt  \mbox{[}read\mbox{]}}}}
\label{mw__st__list_8h_bb1234b841c396d1f5345062dcf8cb81}


\hypertarget{mw__st__list_8h_296847bebae85dbc835e711cd0e9637c}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeGroup\_\-getName@{mwSametimeGroup\_\-getName}}
\index{mwSametimeGroup\_\-getName@{mwSametimeGroup\_\-getName}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$ mwSametimeGroup\_\-getName (struct {\bf mwSametimeGroup} $\ast$ {\em g})}}
\label{mw__st__list_8h_296847bebae85dbc835e711cd0e9637c}


\hypertarget{mw__st__list_8h_1c9eb0f2f666416d6ecd91c5107a7b05}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeGroup\_\-getType@{mwSametimeGroup\_\-getType}}
\index{mwSametimeGroup\_\-getType@{mwSametimeGroup\_\-getType}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf mwSametimeGroupType} mwSametimeGroup\_\-getType (struct {\bf mwSametimeGroup} $\ast$ {\em g})}}
\label{mw__st__list_8h_1c9eb0f2f666416d6ecd91c5107a7b05}


\hypertarget{mw__st__list_8h_956dcc093ff8aef0a0d79cf412be424a}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeGroup\_\-getUsers@{mwSametimeGroup\_\-getUsers}}
\index{mwSametimeGroup\_\-getUsers@{mwSametimeGroup\_\-getUsers}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}GList$\ast$ mwSametimeGroup\_\-getUsers (struct {\bf mwSametimeGroup} $\ast$ {\em g})}}
\label{mw__st__list_8h_956dcc093ff8aef0a0d79cf412be424a}


Get a GList snapshot of the users in a list. 

\hypertarget{mw__st__list_8h_f60b92182c95f3110bc088bec3fdf82d}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeGroup\_\-isOpen@{mwSametimeGroup\_\-isOpen}}
\index{mwSametimeGroup\_\-isOpen@{mwSametimeGroup\_\-isOpen}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}gboolean mwSametimeGroup\_\-isOpen (struct {\bf mwSametimeGroup} $\ast$ {\em g})}}
\label{mw__st__list_8h_f60b92182c95f3110bc088bec3fdf82d}


\hypertarget{mw__st__list_8h_5cbae1e76333389ea7972d0155ad92a3}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeGroup\_\-new@{mwSametimeGroup\_\-new}}
\index{mwSametimeGroup\_\-new@{mwSametimeGroup\_\-new}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}struct {\bf mwSametimeGroup}$\ast$ mwSametimeGroup\_\-new (struct {\bf mwSametimeList} $\ast$ {\em l}, \/  enum {\bf mwSametimeGroupType} {\em type}, \/  const char $\ast$ {\em name})\hspace{0.3cm}{\tt  \mbox{[}read\mbox{]}}}}
\label{mw__st__list_8h_5cbae1e76333389ea7972d0155ad92a3}


Create a new group in a list. 

\hypertarget{mw__st__list_8h_61c6c15ef09d6622fe9aeb8d8af65dea}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeGroup\_\-setAlias@{mwSametimeGroup\_\-setAlias}}
\index{mwSametimeGroup\_\-setAlias@{mwSametimeGroup\_\-setAlias}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void mwSametimeGroup\_\-setAlias (struct {\bf mwSametimeGroup} $\ast$ {\em g}, \/  const char $\ast$ {\em alias})}}
\label{mw__st__list_8h_61c6c15ef09d6622fe9aeb8d8af65dea}


\hypertarget{mw__st__list_8h_a9f4dc8cea4b7fcdb17edfe52117e59e}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeGroup\_\-setOpen@{mwSametimeGroup\_\-setOpen}}
\index{mwSametimeGroup\_\-setOpen@{mwSametimeGroup\_\-setOpen}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void mwSametimeGroup\_\-setOpen (struct {\bf mwSametimeGroup} $\ast$ {\em g}, \/  gboolean {\em open})}}
\label{mw__st__list_8h_a9f4dc8cea4b7fcdb17edfe52117e59e}


\hypertarget{mw__st__list_8h_9459fb70bdb908c29dcf60b71552a403}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeList\_\-findGroup@{mwSametimeList\_\-findGroup}}
\index{mwSametimeList\_\-findGroup@{mwSametimeList\_\-findGroup}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}struct {\bf mwSametimeGroup}$\ast$ mwSametimeList\_\-findGroup (struct {\bf mwSametimeList} $\ast$ {\em l}, \/  const char $\ast$ {\em name})\hspace{0.3cm}{\tt  \mbox{[}read\mbox{]}}}}
\label{mw__st__list_8h_9459fb70bdb908c29dcf60b71552a403}


\hypertarget{mw__st__list_8h_24b6daf1da8c15b9e7ca5d11a97c974c}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeList\_\-free@{mwSametimeList\_\-free}}
\index{mwSametimeList\_\-free@{mwSametimeList\_\-free}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void mwSametimeList\_\-free (struct {\bf mwSametimeList} $\ast$ {\em l})}}
\label{mw__st__list_8h_24b6daf1da8c15b9e7ca5d11a97c974c}


Free the list, all of its groups, and all of the groups' members. 

\hypertarget{mw__st__list_8h_86df0bcac8db117ae3358158d3482ae2}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeList\_\-get@{mwSametimeList\_\-get}}
\index{mwSametimeList\_\-get@{mwSametimeList\_\-get}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void mwSametimeList\_\-get (struct {\bf mwGetBuffer} $\ast$ {\em b}, \/  struct {\bf mwSametimeList} $\ast$ {\em l})}}
\label{mw__st__list_8h_86df0bcac8db117ae3358158d3482ae2}


Load a sametime list from a buffer. 

The list must be encapsulated as a string (eg, the first two bytes in the buffer should be the length of the string) \hypertarget{mw__st__list_8h_cb7f427294efab1b150e4311a6a30013}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeList\_\-getGroups@{mwSametimeList\_\-getGroups}}
\index{mwSametimeList\_\-getGroups@{mwSametimeList\_\-getGroups}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}GList$\ast$ mwSametimeList\_\-getGroups (struct {\bf mwSametimeList} $\ast$ {\em l})}}
\label{mw__st__list_8h_cb7f427294efab1b150e4311a6a30013}


Get a GList snapshot of the groups in a list. 

\hypertarget{mw__st__list_8h_3d0310433c25fba86ee008f6272403d1}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeList\_\-getMajor@{mwSametimeList\_\-getMajor}}
\index{mwSametimeList\_\-getMajor@{mwSametimeList\_\-getMajor}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}guint mwSametimeList\_\-getMajor (struct {\bf mwSametimeList} $\ast$ {\em l})}}
\label{mw__st__list_8h_3d0310433c25fba86ee008f6272403d1}


\hypertarget{mw__st__list_8h_68042bfba90ce27b4f983d98cc86edb9}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeList\_\-getMicro@{mwSametimeList\_\-getMicro}}
\index{mwSametimeList\_\-getMicro@{mwSametimeList\_\-getMicro}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}guint mwSametimeList\_\-getMicro (struct {\bf mwSametimeList} $\ast$ {\em l})}}
\label{mw__st__list_8h_68042bfba90ce27b4f983d98cc86edb9}


\hypertarget{mw__st__list_8h_8789726403941fb31b42f00010b0180f}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeList\_\-getMinor@{mwSametimeList\_\-getMinor}}
\index{mwSametimeList\_\-getMinor@{mwSametimeList\_\-getMinor}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}guint mwSametimeList\_\-getMinor (struct {\bf mwSametimeList} $\ast$ {\em l})}}
\label{mw__st__list_8h_8789726403941fb31b42f00010b0180f}


\hypertarget{mw__st__list_8h_6ed7fd6968c4d921351311c707f3cabf}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeList\_\-load@{mwSametimeList\_\-load}}
\index{mwSametimeList\_\-load@{mwSametimeList\_\-load}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}struct {\bf mwSametimeList}$\ast$ mwSametimeList\_\-load (const char $\ast$ {\em str})\hspace{0.3cm}{\tt  \mbox{[}read\mbox{]}}}}
\label{mw__st__list_8h_6ed7fd6968c4d921351311c707f3cabf}


convert a plain string into a sametime list 

\hypertarget{mw__st__list_8h_edd802ae26018b96aa30a9d84b8e2bfe}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeList\_\-new@{mwSametimeList\_\-new}}
\index{mwSametimeList\_\-new@{mwSametimeList\_\-new}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}struct {\bf mwSametimeList}$\ast$ mwSametimeList\_\-new ()\hspace{0.3cm}{\tt  \mbox{[}read\mbox{]}}}}
\label{mw__st__list_8h_edd802ae26018b96aa30a9d84b8e2bfe}


Create a new list. 

\hypertarget{mw__st__list_8h_146ddcf9a0cb7f89cac27e82accc2c6f}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeList\_\-put@{mwSametimeList\_\-put}}
\index{mwSametimeList\_\-put@{mwSametimeList\_\-put}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void mwSametimeList\_\-put (struct {\bf mwPutBuffer} $\ast$ {\em b}, \/  struct {\bf mwSametimeList} $\ast$ {\em l})}}
\label{mw__st__list_8h_146ddcf9a0cb7f89cac27e82accc2c6f}


Write a sametime list onto a buffer. 

The list will be encapsulated in a string (the first two bytes written will be the length of the rest of the written list data) \hypertarget{mw__st__list_8h_97d9e5598c71ca1b8c495059f5ce1139}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeList\_\-setMajor@{mwSametimeList\_\-setMajor}}
\index{mwSametimeList\_\-setMajor@{mwSametimeList\_\-setMajor}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void mwSametimeList\_\-setMajor (struct {\bf mwSametimeList} $\ast$ {\em l}, \/  guint {\em v})}}
\label{mw__st__list_8h_97d9e5598c71ca1b8c495059f5ce1139}


\hypertarget{mw__st__list_8h_8851984da5f2eea7b503b84f74aded24}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeList\_\-setMicro@{mwSametimeList\_\-setMicro}}
\index{mwSametimeList\_\-setMicro@{mwSametimeList\_\-setMicro}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void mwSametimeList\_\-setMicro (struct {\bf mwSametimeList} $\ast$ {\em l}, \/  guint {\em v})}}
\label{mw__st__list_8h_8851984da5f2eea7b503b84f74aded24}


\hypertarget{mw__st__list_8h_818f2b470246cc12237855ca1abe3d02}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeList\_\-setMinor@{mwSametimeList\_\-setMinor}}
\index{mwSametimeList\_\-setMinor@{mwSametimeList\_\-setMinor}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void mwSametimeList\_\-setMinor (struct {\bf mwSametimeList} $\ast$ {\em l}, \/  guint {\em v})}}
\label{mw__st__list_8h_818f2b470246cc12237855ca1abe3d02}


\hypertarget{mw__st__list_8h_bf3a05001e8b9fb74447c9c7c987a895}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeList\_\-store@{mwSametimeList\_\-store}}
\index{mwSametimeList\_\-store@{mwSametimeList\_\-store}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}char$\ast$ mwSametimeList\_\-store (struct {\bf mwSametimeList} $\ast$ {\em l})}}
\label{mw__st__list_8h_bf3a05001e8b9fb74447c9c7c987a895}


convert a sametime list into a string 

\hypertarget{mw__st__list_8h_3e34c3302305e147d975e278eddd62ce}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeUser\_\-free@{mwSametimeUser\_\-free}}
\index{mwSametimeUser\_\-free@{mwSametimeUser\_\-free}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void mwSametimeUser\_\-free (struct {\bf mwSametimeUser} $\ast$ {\em u})}}
\label{mw__st__list_8h_3e34c3302305e147d975e278eddd62ce}


Remove user from its group, and free it. 

\hypertarget{mw__st__list_8h_1ad661addb3d5d735e4c22492bf4e40b}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeUser\_\-getAlias@{mwSametimeUser\_\-getAlias}}
\index{mwSametimeUser\_\-getAlias@{mwSametimeUser\_\-getAlias}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$ mwSametimeUser\_\-getAlias (struct {\bf mwSametimeUser} $\ast$ {\em u})}}
\label{mw__st__list_8h_1ad661addb3d5d735e4c22492bf4e40b}


\hypertarget{mw__st__list_8h_aa3d6dfc4853603a4306ef9d35a3fdac}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeUser\_\-getCommunity@{mwSametimeUser\_\-getCommunity}}
\index{mwSametimeUser\_\-getCommunity@{mwSametimeUser\_\-getCommunity}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$ mwSametimeUser\_\-getCommunity (struct {\bf mwSametimeUser} $\ast$ {\em u})}}
\label{mw__st__list_8h_aa3d6dfc4853603a4306ef9d35a3fdac}


\hypertarget{mw__st__list_8h_d6365cdf88668606b45d7485ea0aa644}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeUser\_\-getGroup@{mwSametimeUser\_\-getGroup}}
\index{mwSametimeUser\_\-getGroup@{mwSametimeUser\_\-getGroup}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}struct {\bf mwSametimeGroup}$\ast$ mwSametimeUser\_\-getGroup (struct {\bf mwSametimeUser} $\ast$ {\em u})\hspace{0.3cm}{\tt  \mbox{[}read\mbox{]}}}}
\label{mw__st__list_8h_d6365cdf88668606b45d7485ea0aa644}


\hypertarget{mw__st__list_8h_2d90874d7d520a876ec31992e3f2ea9f}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeUser\_\-getShortName@{mwSametimeUser\_\-getShortName}}
\index{mwSametimeUser\_\-getShortName@{mwSametimeUser\_\-getShortName}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$ mwSametimeUser\_\-getShortName (struct {\bf mwSametimeUser} $\ast$ {\em u})}}
\label{mw__st__list_8h_2d90874d7d520a876ec31992e3f2ea9f}


\hypertarget{mw__st__list_8h_56588fb0e8373b5275b4140a61b3621b}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeUser\_\-getType@{mwSametimeUser\_\-getType}}
\index{mwSametimeUser\_\-getType@{mwSametimeUser\_\-getType}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf mwSametimeUserType} mwSametimeUser\_\-getType (struct {\bf mwSametimeUser} $\ast$ {\em u})}}
\label{mw__st__list_8h_56588fb0e8373b5275b4140a61b3621b}


\hypertarget{mw__st__list_8h_0ba53c8c6bffc70ebb04cd62c89f8186}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeUser\_\-getUser@{mwSametimeUser\_\-getUser}}
\index{mwSametimeUser\_\-getUser@{mwSametimeUser\_\-getUser}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$ mwSametimeUser\_\-getUser (struct {\bf mwSametimeUser} $\ast$ {\em u})}}
\label{mw__st__list_8h_0ba53c8c6bffc70ebb04cd62c89f8186}


\hypertarget{mw__st__list_8h_b1cc894d9c0903db2b9de07a126dc6e6}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeUser\_\-new@{mwSametimeUser\_\-new}}
\index{mwSametimeUser\_\-new@{mwSametimeUser\_\-new}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}struct {\bf mwSametimeUser}$\ast$ mwSametimeUser\_\-new (struct {\bf mwSametimeGroup} $\ast$ {\em g}, \/  enum {\bf mwSametimeUserType} {\em type}, \/  struct {\bf mwIdBlock} $\ast$ {\em user})\hspace{0.3cm}{\tt  \mbox{[}read\mbox{]}}}}
\label{mw__st__list_8h_b1cc894d9c0903db2b9de07a126dc6e6}


Create a user in a group. 

\hypertarget{mw__st__list_8h_f49e9faa2568d3feb02dbb5ca3c034b1}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeUser\_\-setAlias@{mwSametimeUser\_\-setAlias}}
\index{mwSametimeUser\_\-setAlias@{mwSametimeUser\_\-setAlias}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void mwSametimeUser\_\-setAlias (struct {\bf mwSametimeUser} $\ast$ {\em u}, \/  const char $\ast$ {\em alias})}}
\label{mw__st__list_8h_f49e9faa2568d3feb02dbb5ca3c034b1}


\hypertarget{mw__st__list_8h_13f35f7da41c009ae5045f26678b4d78}{
\index{mw\_\-st\_\-list.h@{mw\_\-st\_\-list.h}!mwSametimeUser\_\-setShortName@{mwSametimeUser\_\-setShortName}}
\index{mwSametimeUser\_\-setShortName@{mwSametimeUser\_\-setShortName}!mw_st_list.h@{mw\_\-st\_\-list.h}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void mwSametimeUser\_\-setShortName (struct {\bf mwSametimeUser} $\ast$ {\em u}, \/  const char $\ast$ {\em name})}}
\label{mw__st__list_8h_13f35f7da41c009ae5045f26678b4d78}


