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 struct NBNameCache;
  21
  22 /* Represents an entry in the name cache.  If the NetBIOS name is known, it's
  23  * in nbname.  Otherwise, nbname begins with '*'.  numAddresses defines the
  24  * number of addresses in addresses.
  25  * Notice that it allows multiple addresses per name, but doesn't explicitly
  26  * allow group names.  That's because all names so far are unique; if a use for
  27  * group names comes up, adding a flag here is simple enough.
  28  * Also, only the first NCBNAMSZ - 1 bytes are considered significant.  This is
  29  * because a name may have been resolved using DNS, and the suffix byte is
  30  * always truncated for DNS lookups.
  31  */
  32 typedef struct _NBNameCacheEntry
  33 {
  34     UCHAR name[NCBNAMSZ];
  35     UCHAR nbname[NCBNAMSZ];
  36     DWORD numAddresses;
  37     DWORD addresses[1];
  38 } NBNameCacheEntry;
  39
  40 /* Functions that create, manipulate, and destroy a name cache.  Thread-safe,
  41  * with the exception of NBNameCacheDestroy--ensure that no other threads are
  42  * manipulating the cache before destroying it.
  43  */
  44
  45 /* Allocates a new name cache from heap, and sets the expire time on new
  46  * entries to entryExpireTimeMS after a cache entry is added.
  47  */
  48 struct NBNameCache *NBNameCacheCreate(HANDLE heap, DWORD entryExpireTimeMS) DECLSPEC_HIDDEN;
  49
  50 /* Adds an entry to the cache.  The entry is assumed to have been allocated
  51  * from the same heap as the name cache; the name cache will own the entry
  52  * from now on.  The entry's expire time is initialized at this time to
  53  * entryExpireTimeMS + the current time in MS.  If an existing entry with the
  54  * same name was in the cache, the entry is replaced.  Returns TRUE on success
  55  * or FALSE on failure.
  56  */
  57 BOOL NBNameCacheAddEntry(struct NBNameCache *cache, NBNameCacheEntry *entry) DECLSPEC_HIDDEN;
  58
  59 /* Finds the entry with name name in the cache and returns a pointer to it, or
  60  * NULL if it isn't found.
  61  */
  62 const NBNameCacheEntry *NBNameCacheFindEntry(struct NBNameCache *cache,
  63  const UCHAR name[NCBNAMSZ]) DECLSPEC_HIDDEN;
  64
  65 void NBNameCacheDestroy(struct NBNameCache *cache) DECLSPEC_HIDDEN;
  66
  67 #endif /* ndef __WINE_NBNAMECACHE_H */