mw_srvc_resolve.h

Go to the documentation of this file.

/*
  Meanwhile - Unofficial Lotus Sametime Community Client Library
  Copyright (C) 2004  Christopher (siege) O'Brien
  
  This library is free software; you can redistribute it and/or
  modify it under the terms of the GNU Library General Public
  License as published by the Free Software Foundation; either
  version 2 of the License, or (at your option) any later version.
  
  This library is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  Library General Public License for more details.
  
  You should have received a copy of the GNU Library General Public
  License along with this library; if not, write to the Free
  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
*/

#ifndef _MW_SRVC_RESOLVE_H
#define _MW_SRVC_RESOLVE_H


#include <glib.h>
#include <glib/glist.h>


#ifdef __cplusplus
extern "C" {
#endif


#define mwService_RESOLVE  0x00000015


#define SEARCH_ERROR  0x00


struct mwServiceResolve;


enum mwResolveFlag {
  mwResolveFlag_UNIQUE    = 0x00000001,

  mwResolveFlag_FIRST     = 0x00000002,

  mwResolveFlag_ALL_DIRS  = 0x00000004,

  mwResolveFlag_USERS     = 0x00000008,

  mwResolveFlag_GROUPS    = 0x00000010,
};


enum mwResolveCode {
  mwResolveCode_SUCCESS     = 0x00000000,

  mwResolveCode_PARTIAL     = 0x00010000,

  mwResolveCode_MULTIPLE    = 0x80020000,

  mwResolveCode_BAD_FORMAT  = 0x80030000,
};


enum mwResolveMatchType {
  mwResolveMatch_USER   = 0x00000001,
  mwResolveMatch_GROUP  = 0x00000002,
};


struct mwResolveMatch {
  char *id;      
  char *name;    
  char *desc;    
  guint32 type;  
};


struct mwResolveResult {
  guint32 code;    
  char *name;      
  GList *matches;  
};


typedef void (*mwResolveHandler)
     (struct mwServiceResolve *srvc,
      guint32 id, guint32 code, GList *results,
      gpointer data);


struct mwServiceResolve *mwServiceResolve_new(struct mwSession *);


guint32 mwServiceResolve_resolve(struct mwServiceResolve *srvc,
                                 GList *queries, enum mwResolveFlag flags,
                                 mwResolveHandler handler,
                                 gpointer data, GDestroyNotify cleanup);


void mwServiceResolve_cancelResolve(struct mwServiceResolve *, guint32);


#ifdef __cplusplus
}
#endif


#endif /* _MW_SRVC_RESOLVE_H */

---