\hypertarget{mw__srvc__dir_8h}{ \section{mw\_\-srvc\_\-dir.h File Reference} \label{mw__srvc__dir_8h}\index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}} } {\tt \#include $<$glib.h$>$}\par {\tt \#include $<$glib/glist.h$>$}\par \subsection*{Data Structures} \begin{CompactItemize} \item struct \hyperlink{structmwDirectoryHandler}{mwDirectoryHandler} \begin{CompactList}\small\item\em handles asynchronous events for a directory service instance \item\end{CompactList}\item struct \hyperlink{structmwDirectoryMember}{mwDirectoryMember} \end{CompactItemize} \subsection*{Defines} \begin{CompactItemize} \item \#define \hyperlink{mw__srvc__dir_8h_d14f85f7524da53701b6815b40bd3031}{\_\-MW\_\-SERV\_\-DIR\_\-H} \item \#define \hyperlink{mw__srvc__dir_8h_9e8e363d3e984cb248f780ecf7c669b7}{DIR\_\-SEARCH\_\-ERROR}~0x00000000 \begin{CompactList}\small\item\em return value of directory searches that fail \item\end{CompactList}\item \#define \hyperlink{mw__srvc__dir_8h_3e71e58bfa721b29af1e8e6bea0c210d}{MW\_\-DIRECTORY\_\-IS\_\-NEW}(dir)~MW\_\-DIRECTORY\_\-IS\_\-STATE((dir), mwDirectory\_\-NEW) \item \#define \hyperlink{mw__srvc__dir_8h_59dee2af6e326396710262410a83727b}{MW\_\-DIRECTORY\_\-IS\_\-OPEN}(dir)~MW\_\-DIRECTORY\_\-IS\_\-STATE((dir), mwDirectory\_\-OPEN) \item \#define \hyperlink{mw__srvc__dir_8h_61b98cd6f71f89e50d37d1976c1b7e1f}{MW\_\-DIRECTORY\_\-IS\_\-PENDING}(dir)~MW\_\-DIRECTORY\_\-IS\_\-STATE((dir), mwDirectory\_\-PENDING) \item \#define \hyperlink{mw__srvc__dir_8h_31c29620bbcc76eed48040a16a7c0af1}{MW\_\-DIRECTORY\_\-IS\_\-STATE}(dir, \hyperlink{structmwService_b5adc0f5a0cbeddaece7a4512ec66099}{state})~(mwDirectory\_\-getState(dir) == (\hyperlink{structmwService_b5adc0f5a0cbeddaece7a4512ec66099}{state})) \item \#define \hyperlink{mw__srvc__dir_8h_e09f7e7e838b943ab68103d5be873cf6}{SERVICE\_\-DIRECTORY}~0x0000001a \end{CompactItemize} \subsection*{Typedefs} \begin{CompactItemize} \item typedef void($\ast$ \hyperlink{mw__srvc__dir_8h_81dc6682023f70d8bf2e523fdf37e77e}{mwSearchHandler} )(struct \hyperlink{structmwDirectory}{mwDirectory} $\ast$dir, guint32 code, guint32 offset, GList $\ast$members) \begin{CompactList}\small\item\em Appropriate function signature for handling directory search results. \item\end{CompactList}\end{CompactItemize} \subsection*{Enumerations} \begin{CompactItemize} \item enum \hyperlink{mw__srvc__dir_8h_1f72abe2e707f73a2b29ab1dda42c903}{mwDirectoryMemberType} \{ \par \hyperlink{mw__srvc__dir_8h_1f72abe2e707f73a2b29ab1dda42c9034df8201340e66f52d8f90300bac9da36}{mwDirectoryMember\_\-USER} = 0x0000, \par \hyperlink{mw__srvc__dir_8h_1f72abe2e707f73a2b29ab1dda42c9032250ec76f552aa18e0e7a74f66573f67}{mwDirectoryMember\_\-GROUP} = 0x0001 \} \item enum \hyperlink{mw__srvc__dir_8h_60044a1a52101f8cc5b9d6a3b7a4d801}{mwDirectoryState} \{ \par \hyperlink{mw__srvc__dir_8h_60044a1a52101f8cc5b9d6a3b7a4d801a23fa4280674777515fdf7127a9994ec}{mwDirectory\_\-NEW}, \par \hyperlink{mw__srvc__dir_8h_60044a1a52101f8cc5b9d6a3b7a4d801e8e0e99d2620433b2d7caa87e4f8010a}{mwDirectory\_\-PENDING}, \par \hyperlink{mw__srvc__dir_8h_60044a1a52101f8cc5b9d6a3b7a4d8017dfd76f714ee09bc65c7c83ce3159fe8}{mwDirectory\_\-OPEN}, \par \hyperlink{mw__srvc__dir_8h_60044a1a52101f8cc5b9d6a3b7a4d80110be11afe4f1c5faaeee216827c556ae}{mwDirectory\_\-ERROR}, \par \hyperlink{mw__srvc__dir_8h_60044a1a52101f8cc5b9d6a3b7a4d80149f46e4de9c565c09de4db0a1cb6073f}{mwDirectory\_\-UNKNOWN} \} \end{CompactItemize} \subsection*{Functions} \begin{CompactItemize} \item GList $\ast$ \hyperlink{mw__srvc__dir_8h_d19477b511ad0a0240646eeaad26976c}{mwAddressBook\_\-getDirectories} (struct \hyperlink{structmwAddressBook}{mwAddressBook} $\ast$book) \begin{CompactList}\small\item\em list of directories associated with address book. \item\end{CompactList}\item const char $\ast$ \hyperlink{mw__srvc__dir_8h_9be5eacaa47c1b40a6d6e6865a50efb5}{mwAddressBook\_\-getName} (struct \hyperlink{structmwAddressBook}{mwAddressBook} $\ast$book) \begin{CompactList}\small\item\em the name of the address book \item\end{CompactList}\item int \hyperlink{mw__srvc__dir_8h_ee4a5d99e7505d038ce21f5014c8956e}{mwDirectory\_\-destroy} (struct \hyperlink{structmwDirectory}{mwDirectory} $\ast$dir) \begin{CompactList}\small\item\em close and free the directory, and unassociate it with its owning address book and service \item\end{CompactList}\item struct \hyperlink{structmwAddressBook}{mwAddressBook} $\ast$ \hyperlink{mw__srvc__dir_8h_e6814f65378ee93bede00fc3189cc906}{mwDirectory\_\-getAddressBook} (struct \hyperlink{structmwDirectory}{mwDirectory} $\ast$dir) \begin{CompactList}\small\item\em reference owning address book \item\end{CompactList}\item gpointer \hyperlink{mw__srvc__dir_8h_635923e640e1679a7e8ad72da82bd124}{mwDirectory\_\-getClientData} (struct \hyperlink{structmwDirectory}{mwDirectory} $\ast$dir) \begin{CompactList}\small\item\em reference associated client data \item\end{CompactList}\item struct \hyperlink{structmwServiceDirectory}{mwServiceDirectory} $\ast$ \hyperlink{mw__srvc__dir_8h_b1e972026a1b564187df0b94539ad496}{mwDirectory\_\-getService} (struct \hyperlink{structmwDirectory}{mwDirectory} $\ast$dir) \begin{CompactList}\small\item\em reference owning service \item\end{CompactList}\item enum \hyperlink{mw__srvc__dir_8h_60044a1a52101f8cc5b9d6a3b7a4d801}{mwDirectoryState} \hyperlink{mw__srvc__dir_8h_ac64837707b8912f6663943323fc2b91}{mwDirectory\_\-getState} (struct \hyperlink{structmwDirectory}{mwDirectory} $\ast$dir) \item struct \hyperlink{structmwDirectory}{mwDirectory} $\ast$ \hyperlink{mw__srvc__dir_8h_26725adc1b0a0e46f65e5b1fda318678}{mwDirectory\_\-new} (struct \hyperlink{structmwAddressBook}{mwAddressBook} $\ast$book) \begin{CompactList}\small\item\em allocate a new directory based off the given address book \item\end{CompactList}\item int \hyperlink{mw__srvc__dir_8h_d48d6fefb1b5bc3b394f0cd1f705a355}{mwDirectory\_\-next} (struct \hyperlink{structmwDirectory}{mwDirectory} $\ast$dir) \begin{CompactList}\small\item\em continue a search into its next results \item\end{CompactList}\item int \hyperlink{mw__srvc__dir_8h_8b4c2367f50ad288b7a6902d7ea1d3d9}{mwDirectory\_\-open} (struct \hyperlink{structmwDirectory}{mwDirectory} $\ast$dir, \hyperlink{mw__srvc__dir_8h_81dc6682023f70d8bf2e523fdf37e77e}{mwSearchHandler} cb) \begin{CompactList}\small\item\em initialize a directory. \item\end{CompactList}\item int \hyperlink{mw__srvc__dir_8h_f875cf16eb3af5c5ddcf2663f5cb4961}{mwDirectory\_\-previous} (struct \hyperlink{structmwDirectory}{mwDirectory} $\ast$dir) \begin{CompactList}\small\item\em continue a search into its previous results \item\end{CompactList}\item void \hyperlink{mw__srvc__dir_8h_2bdd0844643324c5aeaedff5762a9a24}{mwDirectory\_\-removeClientData} (struct \hyperlink{structmwDirectory}{mwDirectory} $\ast$dir) \begin{CompactList}\small\item\em remove and cleanup user data \item\end{CompactList}\item int \hyperlink{mw__srvc__dir_8h_9dbd426e14906b932c49fc8bf73b05b3}{mwDirectory\_\-search} (struct \hyperlink{structmwDirectory}{mwDirectory} $\ast$dir, const char $\ast$query) \begin{CompactList}\small\item\em initiate a search on an open directory \item\end{CompactList}\item void \hyperlink{mw__srvc__dir_8h_c1f534a4ae485697d28607fb413f8adc}{mwDirectory\_\-setClientData} (struct \hyperlink{structmwDirectory}{mwDirectory} $\ast$dir, gpointer data, GDestroyNotify \hyperlink{structmwService_9b86cc0545150a4fde3ab3060e803e58}{clear}) \begin{CompactList}\small\item\em set client data. \item\end{CompactList}\item GList $\ast$ \hyperlink{mw__srvc__dir_8h_48dff54d4ac64af11d3108ca6d6881c0}{mwServiceDirectory\_\-getAddressBooks} (struct \hyperlink{structmwServiceDirectory}{mwServiceDirectory} $\ast$srvc) \begin{CompactList}\small\item\em most recent list of address books available in service \item\end{CompactList}\item GList $\ast$ \hyperlink{mw__srvc__dir_8h_1d42ec96164218c4c632bb75ae055fb9}{mwServiceDirectory\_\-getDirectories} (struct \hyperlink{structmwServiceDirectory}{mwServiceDirectory} $\ast$srvc) \begin{CompactList}\small\item\em list of directories in the service \item\end{CompactList}\item struct \hyperlink{structmwDirectoryHandler}{mwDirectoryHandler} $\ast$ \hyperlink{mw__srvc__dir_8h_dadae841da1783e2c0a9a52d862bfae3}{mwServiceDirectory\_\-getHandler} (struct \hyperlink{structmwServiceDirectory}{mwServiceDirectory} $\ast$srvc) \begin{CompactList}\small\item\em the handler associated with the service at its creation \item\end{CompactList}\item struct \hyperlink{structmwServiceDirectory}{mwServiceDirectory} $\ast$ \hyperlink{mw__srvc__dir_8h_0e56c0fb35eca0aaffcaee3faa53192a}{mwServiceDirectory\_\-new} (struct \hyperlink{structmwSession}{mwSession} $\ast$\hyperlink{structmwService_0c2badd2256155b2bee149fa4b57b7d6}{session}, struct \hyperlink{structmwDirectoryHandler}{mwDirectoryHandler} $\ast$handler) \begin{CompactList}\small\item\em Allocate a new directory service instance for use with session. \item\end{CompactList}\item int \hyperlink{mw__srvc__dir_8h_29a526b9ae82e319c04ac7fb9890bc36}{mwServiceDirectory\_\-refreshAddressBooks} (struct \hyperlink{structmwServiceDirectory}{mwServiceDirectory} $\ast$srvc) \begin{CompactList}\small\item\em submit a request to obtain an updated list of address books from service \item\end{CompactList}\end{CompactItemize} \subsection{Define Documentation} \hypertarget{mw__srvc__dir_8h_d14f85f7524da53701b6815b40bd3031}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!\_\-MW\_\-SERV\_\-DIR\_\-H@{\_\-MW\_\-SERV\_\-DIR\_\-H}} \index{\_\-MW\_\-SERV\_\-DIR\_\-H@{\_\-MW\_\-SERV\_\-DIR\_\-H}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}\#define \_\-MW\_\-SERV\_\-DIR\_\-H}} \label{mw__srvc__dir_8h_d14f85f7524da53701b6815b40bd3031} \hypertarget{mw__srvc__dir_8h_9e8e363d3e984cb248f780ecf7c669b7}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!DIR\_\-SEARCH\_\-ERROR@{DIR\_\-SEARCH\_\-ERROR}} \index{DIR\_\-SEARCH\_\-ERROR@{DIR\_\-SEARCH\_\-ERROR}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}\#define DIR\_\-SEARCH\_\-ERROR~0x00000000}} \label{mw__srvc__dir_8h_9e8e363d3e984cb248f780ecf7c669b7} return value of directory searches that fail \hypertarget{mw__srvc__dir_8h_3e71e58bfa721b29af1e8e6bea0c210d}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!MW\_\-DIRECTORY\_\-IS\_\-NEW@{MW\_\-DIRECTORY\_\-IS\_\-NEW}} \index{MW\_\-DIRECTORY\_\-IS\_\-NEW@{MW\_\-DIRECTORY\_\-IS\_\-NEW}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}\#define MW\_\-DIRECTORY\_\-IS\_\-NEW(dir)~MW\_\-DIRECTORY\_\-IS\_\-STATE((dir), mwDirectory\_\-NEW)}} \label{mw__srvc__dir_8h_3e71e58bfa721b29af1e8e6bea0c210d} \hypertarget{mw__srvc__dir_8h_59dee2af6e326396710262410a83727b}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!MW\_\-DIRECTORY\_\-IS\_\-OPEN@{MW\_\-DIRECTORY\_\-IS\_\-OPEN}} \index{MW\_\-DIRECTORY\_\-IS\_\-OPEN@{MW\_\-DIRECTORY\_\-IS\_\-OPEN}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}\#define MW\_\-DIRECTORY\_\-IS\_\-OPEN(dir)~MW\_\-DIRECTORY\_\-IS\_\-STATE((dir), mwDirectory\_\-OPEN)}} \label{mw__srvc__dir_8h_59dee2af6e326396710262410a83727b} \hypertarget{mw__srvc__dir_8h_61b98cd6f71f89e50d37d1976c1b7e1f}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!MW\_\-DIRECTORY\_\-IS\_\-PENDING@{MW\_\-DIRECTORY\_\-IS\_\-PENDING}} \index{MW\_\-DIRECTORY\_\-IS\_\-PENDING@{MW\_\-DIRECTORY\_\-IS\_\-PENDING}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}\#define MW\_\-DIRECTORY\_\-IS\_\-PENDING(dir)~MW\_\-DIRECTORY\_\-IS\_\-STATE((dir), mwDirectory\_\-PENDING)}} \label{mw__srvc__dir_8h_61b98cd6f71f89e50d37d1976c1b7e1f} \hypertarget{mw__srvc__dir_8h_31c29620bbcc76eed48040a16a7c0af1}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!MW\_\-DIRECTORY\_\-IS\_\-STATE@{MW\_\-DIRECTORY\_\-IS\_\-STATE}} \index{MW\_\-DIRECTORY\_\-IS\_\-STATE@{MW\_\-DIRECTORY\_\-IS\_\-STATE}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}\#define MW\_\-DIRECTORY\_\-IS\_\-STATE(dir, {\bf state})~(mwDirectory\_\-getState(dir) == ({\bf state}))}} \label{mw__srvc__dir_8h_31c29620bbcc76eed48040a16a7c0af1} \hypertarget{mw__srvc__dir_8h_e09f7e7e838b943ab68103d5be873cf6}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!SERVICE\_\-DIRECTORY@{SERVICE\_\-DIRECTORY}} \index{SERVICE\_\-DIRECTORY@{SERVICE\_\-DIRECTORY}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}\#define SERVICE\_\-DIRECTORY~0x0000001a}} \label{mw__srvc__dir_8h_e09f7e7e838b943ab68103d5be873cf6} \subsection{Typedef Documentation} \hypertarget{mw__srvc__dir_8h_81dc6682023f70d8bf2e523fdf37e77e}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwSearchHandler@{mwSearchHandler}} \index{mwSearchHandler@{mwSearchHandler}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}typedef void($\ast$ {\bf mwSearchHandler})(struct {\bf mwDirectory} $\ast$dir, guint32 code, guint32 offset, GList $\ast$members)}} \label{mw__srvc__dir_8h_81dc6682023f70d8bf2e523fdf37e77e} Appropriate function signature for handling directory search results. \subsection{Enumeration Type Documentation} \hypertarget{mw__srvc__dir_8h_1f72abe2e707f73a2b29ab1dda42c903}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwDirectoryMemberType@{mwDirectoryMemberType}} \index{mwDirectoryMemberType@{mwDirectoryMemberType}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf mwDirectoryMemberType}}} \label{mw__srvc__dir_8h_1f72abe2e707f73a2b29ab1dda42c903} \begin{Desc} \item[Enumerator: ]\par \begin{description} \index{mwDirectoryMember\_\-USER@{mwDirectoryMember\_\-USER}!mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}}\index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwDirectoryMember\_\-USER@{mwDirectoryMember\_\-USER}}\item[{\em \hypertarget{mw__srvc__dir_8h_1f72abe2e707f73a2b29ab1dda42c9034df8201340e66f52d8f90300bac9da36}{ mwDirectoryMember\_\-USER} \label{mw__srvc__dir_8h_1f72abe2e707f73a2b29ab1dda42c9034df8201340e66f52d8f90300bac9da36} }]\index{mwDirectoryMember\_\-GROUP@{mwDirectoryMember\_\-GROUP}!mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}}\index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwDirectoryMember\_\-GROUP@{mwDirectoryMember\_\-GROUP}}\item[{\em \hypertarget{mw__srvc__dir_8h_1f72abe2e707f73a2b29ab1dda42c9032250ec76f552aa18e0e7a74f66573f67}{ mwDirectoryMember\_\-GROUP} \label{mw__srvc__dir_8h_1f72abe2e707f73a2b29ab1dda42c9032250ec76f552aa18e0e7a74f66573f67} }]\end{description} \end{Desc} \hypertarget{mw__srvc__dir_8h_60044a1a52101f8cc5b9d6a3b7a4d801}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwDirectoryState@{mwDirectoryState}} \index{mwDirectoryState@{mwDirectoryState}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf mwDirectoryState}}} \label{mw__srvc__dir_8h_60044a1a52101f8cc5b9d6a3b7a4d801} \begin{Desc} \item[Enumerator: ]\par \begin{description} \index{mwDirectory\_\-NEW@{mwDirectory\_\-NEW}!mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}}\index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwDirectory\_\-NEW@{mwDirectory\_\-NEW}}\item[{\em \hypertarget{mw__srvc__dir_8h_60044a1a52101f8cc5b9d6a3b7a4d801a23fa4280674777515fdf7127a9994ec}{ mwDirectory\_\-NEW} \label{mw__srvc__dir_8h_60044a1a52101f8cc5b9d6a3b7a4d801a23fa4280674777515fdf7127a9994ec} }]directory is created, but not open \index{mwDirectory\_\-PENDING@{mwDirectory\_\-PENDING}!mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}}\index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwDirectory\_\-PENDING@{mwDirectory\_\-PENDING}}\item[{\em \hypertarget{mw__srvc__dir_8h_60044a1a52101f8cc5b9d6a3b7a4d801e8e0e99d2620433b2d7caa87e4f8010a}{ mwDirectory\_\-PENDING} \label{mw__srvc__dir_8h_60044a1a52101f8cc5b9d6a3b7a4d801e8e0e99d2620433b2d7caa87e4f8010a} }]directory has in the process of opening \index{mwDirectory\_\-OPEN@{mwDirectory\_\-OPEN}!mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}}\index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwDirectory\_\-OPEN@{mwDirectory\_\-OPEN}}\item[{\em \hypertarget{mw__srvc__dir_8h_60044a1a52101f8cc5b9d6a3b7a4d8017dfd76f714ee09bc65c7c83ce3159fe8}{ mwDirectory\_\-OPEN} \label{mw__srvc__dir_8h_60044a1a52101f8cc5b9d6a3b7a4d8017dfd76f714ee09bc65c7c83ce3159fe8} }]directory is open \index{mwDirectory\_\-ERROR@{mwDirectory\_\-ERROR}!mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}}\index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwDirectory\_\-ERROR@{mwDirectory\_\-ERROR}}\item[{\em \hypertarget{mw__srvc__dir_8h_60044a1a52101f8cc5b9d6a3b7a4d80110be11afe4f1c5faaeee216827c556ae}{ mwDirectory\_\-ERROR} \label{mw__srvc__dir_8h_60044a1a52101f8cc5b9d6a3b7a4d80110be11afe4f1c5faaeee216827c556ae} }]error opening or using directory \index{mwDirectory\_\-UNKNOWN@{mwDirectory\_\-UNKNOWN}!mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}}\index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwDirectory\_\-UNKNOWN@{mwDirectory\_\-UNKNOWN}}\item[{\em \hypertarget{mw__srvc__dir_8h_60044a1a52101f8cc5b9d6a3b7a4d80149f46e4de9c565c09de4db0a1cb6073f}{ mwDirectory\_\-UNKNOWN} \label{mw__srvc__dir_8h_60044a1a52101f8cc5b9d6a3b7a4d80149f46e4de9c565c09de4db0a1cb6073f} }]error determining directory state \end{description} \end{Desc} \subsection{Function Documentation} \hypertarget{mw__srvc__dir_8h_d19477b511ad0a0240646eeaad26976c}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwAddressBook\_\-getDirectories@{mwAddressBook\_\-getDirectories}} \index{mwAddressBook\_\-getDirectories@{mwAddressBook\_\-getDirectories}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}GList$\ast$ mwAddressBook\_\-getDirectories (struct {\bf mwAddressBook} $\ast$ {\em book})}} \label{mw__srvc__dir_8h_d19477b511ad0a0240646eeaad26976c} list of directories associated with address book. Note that the returned GList will need to be free'd after use \hypertarget{mw__srvc__dir_8h_9be5eacaa47c1b40a6d6e6865a50efb5}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwAddressBook\_\-getName@{mwAddressBook\_\-getName}} \index{mwAddressBook\_\-getName@{mwAddressBook\_\-getName}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$ mwAddressBook\_\-getName (struct {\bf mwAddressBook} $\ast$ {\em book})}} \label{mw__srvc__dir_8h_9be5eacaa47c1b40a6d6e6865a50efb5} the name of the address book \hypertarget{mw__srvc__dir_8h_ee4a5d99e7505d038ce21f5014c8956e}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwDirectory\_\-destroy@{mwDirectory\_\-destroy}} \index{mwDirectory\_\-destroy@{mwDirectory\_\-destroy}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}int mwDirectory\_\-destroy (struct {\bf mwDirectory} $\ast$ {\em dir})}} \label{mw__srvc__dir_8h_ee4a5d99e7505d038ce21f5014c8956e} close and free the directory, and unassociate it with its owning address book and service \hypertarget{mw__srvc__dir_8h_e6814f65378ee93bede00fc3189cc906}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwDirectory\_\-getAddressBook@{mwDirectory\_\-getAddressBook}} \index{mwDirectory\_\-getAddressBook@{mwDirectory\_\-getAddressBook}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}struct {\bf mwAddressBook}$\ast$ mwDirectory\_\-getAddressBook (struct {\bf mwDirectory} $\ast$ {\em dir})\hspace{0.3cm}{\tt \mbox{[}read\mbox{]}}}} \label{mw__srvc__dir_8h_e6814f65378ee93bede00fc3189cc906} reference owning address book \hypertarget{mw__srvc__dir_8h_635923e640e1679a7e8ad72da82bd124}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwDirectory\_\-getClientData@{mwDirectory\_\-getClientData}} \index{mwDirectory\_\-getClientData@{mwDirectory\_\-getClientData}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}gpointer mwDirectory\_\-getClientData (struct {\bf mwDirectory} $\ast$ {\em dir})}} \label{mw__srvc__dir_8h_635923e640e1679a7e8ad72da82bd124} reference associated client data \hypertarget{mw__srvc__dir_8h_b1e972026a1b564187df0b94539ad496}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwDirectory\_\-getService@{mwDirectory\_\-getService}} \index{mwDirectory\_\-getService@{mwDirectory\_\-getService}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}struct {\bf mwServiceDirectory}$\ast$ mwDirectory\_\-getService (struct {\bf mwDirectory} $\ast$ {\em dir})\hspace{0.3cm}{\tt \mbox{[}read\mbox{]}}}} \label{mw__srvc__dir_8h_b1e972026a1b564187df0b94539ad496} reference owning service \hypertarget{mw__srvc__dir_8h_ac64837707b8912f6663943323fc2b91}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwDirectory\_\-getState@{mwDirectory\_\-getState}} \index{mwDirectory\_\-getState@{mwDirectory\_\-getState}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf mwDirectoryState} mwDirectory\_\-getState (struct {\bf mwDirectory} $\ast$ {\em dir})}} \label{mw__srvc__dir_8h_ac64837707b8912f6663943323fc2b91} \hypertarget{mw__srvc__dir_8h_26725adc1b0a0e46f65e5b1fda318678}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwDirectory\_\-new@{mwDirectory\_\-new}} \index{mwDirectory\_\-new@{mwDirectory\_\-new}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}struct {\bf mwDirectory}$\ast$ mwDirectory\_\-new (struct {\bf mwAddressBook} $\ast$ {\em book})\hspace{0.3cm}{\tt \mbox{[}read\mbox{]}}}} \label{mw__srvc__dir_8h_26725adc1b0a0e46f65e5b1fda318678} allocate a new directory based off the given address book \hypertarget{mw__srvc__dir_8h_d48d6fefb1b5bc3b394f0cd1f705a355}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwDirectory\_\-next@{mwDirectory\_\-next}} \index{mwDirectory\_\-next@{mwDirectory\_\-next}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}int mwDirectory\_\-next (struct {\bf mwDirectory} $\ast$ {\em dir})}} \label{mw__srvc__dir_8h_d48d6fefb1b5bc3b394f0cd1f705a355} continue a search into its next results \hypertarget{mw__srvc__dir_8h_8b4c2367f50ad288b7a6902d7ea1d3d9}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwDirectory\_\-open@{mwDirectory\_\-open}} \index{mwDirectory\_\-open@{mwDirectory\_\-open}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}int mwDirectory\_\-open (struct {\bf mwDirectory} $\ast$ {\em dir}, {\bf mwSearchHandler} {\em cb})}} \label{mw__srvc__dir_8h_8b4c2367f50ad288b7a6902d7ea1d3d9} initialize a directory. \hypertarget{mw__srvc__dir_8h_f875cf16eb3af5c5ddcf2663f5cb4961}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwDirectory\_\-previous@{mwDirectory\_\-previous}} \index{mwDirectory\_\-previous@{mwDirectory\_\-previous}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}int mwDirectory\_\-previous (struct {\bf mwDirectory} $\ast$ {\em dir})}} \label{mw__srvc__dir_8h_f875cf16eb3af5c5ddcf2663f5cb4961} continue a search into its previous results \hypertarget{mw__srvc__dir_8h_2bdd0844643324c5aeaedff5762a9a24}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwDirectory\_\-removeClientData@{mwDirectory\_\-removeClientData}} \index{mwDirectory\_\-removeClientData@{mwDirectory\_\-removeClientData}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}void mwDirectory\_\-removeClientData (struct {\bf mwDirectory} $\ast$ {\em dir})}} \label{mw__srvc__dir_8h_2bdd0844643324c5aeaedff5762a9a24} remove and cleanup user data \hypertarget{mw__srvc__dir_8h_9dbd426e14906b932c49fc8bf73b05b3}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwDirectory\_\-search@{mwDirectory\_\-search}} \index{mwDirectory\_\-search@{mwDirectory\_\-search}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}int mwDirectory\_\-search (struct {\bf mwDirectory} $\ast$ {\em dir}, const char $\ast$ {\em query})}} \label{mw__srvc__dir_8h_9dbd426e14906b932c49fc8bf73b05b3} initiate a search on an open directory \hypertarget{mw__srvc__dir_8h_c1f534a4ae485697d28607fb413f8adc}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwDirectory\_\-setClientData@{mwDirectory\_\-setClientData}} \index{mwDirectory\_\-setClientData@{mwDirectory\_\-setClientData}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}void mwDirectory\_\-setClientData (struct {\bf mwDirectory} $\ast$ {\em dir}, gpointer {\em data}, GDestroyNotify {\em clear})}} \label{mw__srvc__dir_8h_c1f534a4ae485697d28607fb413f8adc} set client data. If there is an existing clear function, it will not be called \hypertarget{mw__srvc__dir_8h_48dff54d4ac64af11d3108ca6d6881c0}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwServiceDirectory\_\-getAddressBooks@{mwServiceDirectory\_\-getAddressBooks}} \index{mwServiceDirectory\_\-getAddressBooks@{mwServiceDirectory\_\-getAddressBooks}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}GList$\ast$ mwServiceDirectory\_\-getAddressBooks (struct {\bf mwServiceDirectory} $\ast$ {\em srvc})}} \label{mw__srvc__dir_8h_48dff54d4ac64af11d3108ca6d6881c0} most recent list of address books available in service \hypertarget{mw__srvc__dir_8h_1d42ec96164218c4c632bb75ae055fb9}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwServiceDirectory\_\-getDirectories@{mwServiceDirectory\_\-getDirectories}} \index{mwServiceDirectory\_\-getDirectories@{mwServiceDirectory\_\-getDirectories}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}GList$\ast$ mwServiceDirectory\_\-getDirectories (struct {\bf mwServiceDirectory} $\ast$ {\em srvc})}} \label{mw__srvc__dir_8h_1d42ec96164218c4c632bb75ae055fb9} list of directories in the service \hypertarget{mw__srvc__dir_8h_dadae841da1783e2c0a9a52d862bfae3}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwServiceDirectory\_\-getHandler@{mwServiceDirectory\_\-getHandler}} \index{mwServiceDirectory\_\-getHandler@{mwServiceDirectory\_\-getHandler}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}struct {\bf mwDirectoryHandler}$\ast$ mwServiceDirectory\_\-getHandler (struct {\bf mwServiceDirectory} $\ast$ {\em srvc})\hspace{0.3cm}{\tt \mbox{[}read\mbox{]}}}} \label{mw__srvc__dir_8h_dadae841da1783e2c0a9a52d862bfae3} the handler associated with the service at its creation \hypertarget{mw__srvc__dir_8h_0e56c0fb35eca0aaffcaee3faa53192a}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwServiceDirectory\_\-new@{mwServiceDirectory\_\-new}} \index{mwServiceDirectory\_\-new@{mwServiceDirectory\_\-new}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}struct {\bf mwServiceDirectory}$\ast$ mwServiceDirectory\_\-new (struct {\bf mwSession} $\ast$ {\em session}, struct {\bf mwDirectoryHandler} $\ast$ {\em handler})\hspace{0.3cm}{\tt \mbox{[}read\mbox{]}}}} \label{mw__srvc__dir_8h_0e56c0fb35eca0aaffcaee3faa53192a} Allocate a new directory service instance for use with session. \hypertarget{mw__srvc__dir_8h_29a526b9ae82e319c04ac7fb9890bc36}{ \index{mw\_\-srvc\_\-dir.h@{mw\_\-srvc\_\-dir.h}!mwServiceDirectory\_\-refreshAddressBooks@{mwServiceDirectory\_\-refreshAddressBooks}} \index{mwServiceDirectory\_\-refreshAddressBooks@{mwServiceDirectory\_\-refreshAddressBooks}!mw_srvc_dir.h@{mw\_\-srvc\_\-dir.h}} \subsubsection{\setlength{\rightskip}{0pt plus 5cm}int mwServiceDirectory\_\-refreshAddressBooks (struct {\bf mwServiceDirectory} $\ast$ {\em srvc})}} \label{mw__srvc__dir_8h_29a526b9ae82e319c04ac7fb9890bc36} submit a request to obtain an updated list of address books from service