reactos/dll/win32/netapi32/nbnamecache.h

   1 /* Copyright (c) 2003 Juan Lang
   2  *
   3  * This library is free software; you can redistribute it and/or
   4  * modify it under the terms of the GNU Lesser General Public
   5  * License as published by the Free Software Foundation; either
   6  * version 2.1 of the License, or (at your option) any later version.
   7  *
   8  * This library is distributed in the hope that it will be useful,
   9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  11  * Lesser General Public License for more details.
  12  *
  13  * You should have received a copy of the GNU Lesser General Public
  14  * License along with this library; if not, write to the Free Software
  15  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  16  */
  17 #ifndef __WINE_NBNAMECACHE_H
  18 #define __WINE_NBNAMECACHE_H
  19
  20 #define WIN32_NO_STATUS
  21 #define _INC_WINDOWS
  22 #define COM_NO_WINDOWS_H
  23
  24 #include <stdarg.h>
  25
  26 #include <windef.h>
  27 #include <winbase.h>
  28 #include <nb30.h>
  29
  30 struct NBNameCache;
  31
  32 /* Represents an entry in the name cache.  If the NetBIOS name is known, it's
  33  * in nbname.  Otherwise, nbname begins with '*'.  numAddresses defines the
  34  * number of addresses in addresses.
  35  * Notice that it allows multiple addresses per name, but doesn't explicitly
  36  * allow group names.  That's because all names so far are unique; if a use for
  37  * group names comes up, adding a flag here is simple enough.
  38  * Also, only the first NCBNAMSZ - 1 bytes are considered significant.  This is
  39  * because a name may have been resolved using DNS, and the suffix byte is
  40  * always truncated for DNS lookups.
  41  */
  42 typedef struct _NBNameCacheEntry
  43 {
  44     UCHAR name[NCBNAMSZ];
  45     UCHAR nbname[NCBNAMSZ];
  46     DWORD numAddresses;
  47     DWORD addresses[1];
  48 } NBNameCacheEntry;
  49
  50 /* Functions that create, manipulate, and destroy a name cache.  Thread-safe,
  51  * with the exception of NBNameCacheDestroy--ensure that no other threads are
  52  * manipulating the cache before destroying it.
  53  */
  54
  55 /* Allocates a new name cache from heap, and sets the expire time on new
  56  * entries to entryExpireTimeMS after a cache entry is added.
  57  */
  58 struct NBNameCache *NBNameCacheCreate(HANDLE heap, DWORD entryExpireTimeMS);
  59
  60 /* Adds an entry to the cache.  The entry is assumed to have been allocated
  61  * from the same heap as the name cache; the name cache will own the entry
  62  * from now on.  The entry's expire time is initialized at this time to
  63  * entryExpireTimeMS + the current time in MS.  If an existing entry with the
  64  * same name was in the cache, the entry is replaced.  Returns TRUE on success
  65  * or FALSE on failure.
  66  */
  67 BOOL NBNameCacheAddEntry(struct NBNameCache *cache, NBNameCacheEntry *entry);
  68
  69 /* Finds the entry with name name in the cache and returns a pointer to it, or
  70  * NULL if it isn't found.
  71  */
  72 const NBNameCacheEntry *NBNameCacheFindEntry(struct NBNameCache *cache,
  73  const UCHAR name[NCBNAMSZ]);
  74
  75 void NBNameCacheDestroy(struct NBNameCache *cache);
  76
  77 #endif /* ndef __WINE_NBNAMECACHE_H */