Visual Basic Network Services
Netbios: Determine Local Adapter MAC Addresses through LANA Enumeration
     
Posted:   Sunday April 18, 2004
Updated:   Monday December 26, 2011
     
Applies to:   VB4-32, VB5, VB6
Developed with:   VB6, Windows XP
OS restrictions:   None
Author:   VBnet - Randy Birch
     

Related:  

Netbios: Determine Local Adapter MAC Address
SendARP: Determine Local or Remote Adapter MAC Addresses
gethostbyname: Determine Network Host Name and IP Address
Netbios: Determine Local Adapter MAC Addresses through LANA Enumeration
gethostbyaddr: Obtain Host Name from IP Address
IcmpSendEcho: Ping a Machine by IP Address
IcmpSendEcho: Ping a Machine by Host Name

URLDownloadToFile: Obtain Machine's Public IP Behind Router
IcmpSendEcho: Perform a Tracert (Trace Route) in VB with Host Name Resolution
     
 Prerequisites
Installed network card or cards, NetBIOS.

Netbios: Determine Local Adapter MAC Address shows how to retrieve the Medium Access Control (MAC) address for the installed network card. A MAC Address is a unique 48-bit number assigned to the network interface card (NIC) by the manufacturer. On systems with multiple NICs the above routine returns only the MAC address of the first NIC (LANA=0). Since machines can easily support multiple NICs, a method to determine the MAC address of each is required and is presented here.

Retrieving a MAC address using this code requires two things - first, each of the adapters must be active (enabled) in Windows - it can not be disabled through the network settings - just being present in the computer is not enough. The second prerequisite is each adapter must be bound to the NetBIOS protocol either implicilty (NetBIOS protocol assigned to the adapter) or as part of a combined protocol (e.g. IPX/SPX/NetBIOS-compatible Transport Protocol).

My system has two network cards, although typically only one is ever used.  The first illustration (number of adapters = 1) shows the result of the code below when only this adapter is enabled. Illustration two shows the result of the same code with both adapters enabled.

 BAS Module Code
None.

 Form Code
To a form add a command button (Command1) and a list box (List1) along with the following code:

Option Explicit
''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
' Copyright 1996-2011 VBnet/Randy Birch, All Rights Reserved.
' Some pages may also contain other copyrights by the author.
''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
' Distribution: You can freely use this code in your own
'               applications, but you may not reproduce 
'               or publish this code on any web site,
'               online service, or distribute as source 
'               on any media without express permission.
''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''''
Private Const NCBASTAT As Long = &H33
Private Const NCBRESET As Long = &H32
Private Const NCBENUM As Long = &H37    
Private Const NRC_GOODRET As Long = &H0
Private Const MAX_LANA As Long = 254
Private Const NCBNAMSZ As Long = 16
Private Const HEAP_ZERO_MEMORY As Long = &H8
Private Const HEAP_GENERATE_EXCEPTIONS As Long = &H4

Private Type LANA_ENUM
   length As Byte
   adapter_numbers(0 To MAX_LANA) As Byte 'lanas in range 0 to MAX_LANA inclusive
End Type

Private Type NET_CONTROL_BLOCK  'NCB
   ncb_command As Byte
   ncb_retcode As Byte
   ncb_lsn As Byte
   ncb_num As Byte
   ncb_buffer As Long
   ncb_length As Integer
   ncb_callname As String * NCBNAMSZ
   ncb_name As String * NCBNAMSZ
   ncb_rto As Byte
   ncb_sto As Byte
   ncb_post As Long
   ncb_lana_num As Byte
   ncb_cmd_cplt As Byte
   ncb_reserve(0 To 9) As Byte 'if Win64, make (0 to 17)
   ncb_event As Long
End Type

Private Type ADAPTER_STATUS
   adapter_address(0 To 5) As Byte '6 elements
   rev_major As Byte
   reserved0 As Byte
   adapter_type As Byte
   rev_minor As Byte
   duration As Integer
   frmr_recv As Integer
   frmr_xmit As Integer
   iframe_recv_err As Integer
   xmit_aborts As Integer
   xmit_success As Long
   recv_success As Long
   iframe_xmit_err As Integer
   recv_buff_unavail As Integer
   t1_timeouts As Integer
   ti_timeouts As Integer
   Reserved1 As Long
   free_ncbs As Integer
   max_cfg_ncbs As Integer
   max_ncbs As Integer
   xmit_buf_unavail As Integer
   max_dgram_size As Integer
   pending_sess As Integer
   max_cfg_sess As Integer
   max_sess As Integer
   max_sess_pkt_size As Integer
   name_count As Integer
End Type
   
Private Type NAME_BUFFER
   name As String * NCBNAMSZ
   name_num As Integer
   name_flags As Integer
End Type

'when NCBASTAT is specified, the
'ncb_buffer member of NET_CONTROL_BLOCK
'points to a buffer to be filled with
'an ADAPTER_STATUS structure, followed
'by an array of NAME_BUFFER structures
Private Type ASTAT
   adapt As ADAPTER_STATUS
   NameBuff(0 To 30) As NAME_BUFFER
End Type

Private Declare Function Netbios Lib "netapi32.dll" _
  (pncb As NET_CONTROL_BLOCK) As Byte
     
Private Declare Sub CopyMemory Lib "kernel32" _
   Alias "RtlMoveMemory" _
  (hpvDest As Any, ByVal _
   hpvSource As Long, ByVal _
   cbCopy As Long)
     
Private Declare Function GetProcessHeap Lib "kernel32" () As Long

Private Declare Function HeapAlloc Lib "kernel32" _
  (ByVal hHeap As Long, _
   ByVal dwFlags As Long, _
   ByVal dwBytes As Long) As Long
     
Private Declare Function HeapFree Lib "kernel32" _
  (ByVal hHeap As Long, _
   ByVal dwFlags As Long, _
   lpMem As Any) As Long



Private Sub Form_Load()

   Command1.Caption = "Enum Lanas and Addresses"
   
End Sub


Private Sub Command1_Click()

   Dim cnt As Long
   Dim numLanas As Long
   Dim sMACAddresses() As String
   
  'get an array of strings containing the
  'MAC addresses of each NetBIOS-enabled
  'adapter, returning the number of adapters
  'in the array.
  
  'in calling, also pass the character you
  'want as a delimiter between MAC
  'address members
   numLanas = GetNBMacAddresses(sMACAddresses(), " ")  
   
   If numLanas > 0 Then
      
      List1.AddItem "Number of adapters: " & numLanas
      
      For cnt = 0 To numLanas - 1
         List1.AddItem ""
         List1.AddItem "MAC address of lana " & cnt & ":"
         List1.AddItem vbTab & sMACAddresses(cnt)
      Next
      
   Else
      List1.AddItem "No adapters using NetBIOS found"
   End If

End Sub


Private Function GetNBMacAddresses(sMACAddresses() As String, sDelimiter As String) As Long

  'retrieve the MAC addresses for all
  'installed and enabled network controllers
  'bound to the NetBIOS protocol.
   
   Dim cnt As Long
   Dim pASTAT As Long
   Dim buff As String
   Dim lana As LANA_ENUM  'enum values
   Dim ncb As NET_CONTROL_BLOCK
   Dim ast As ASTAT
  
  'Enumerate LAN adapter (LANA) numbers.
  'When NCBENUM is specified the ncb_buffer
  'member points to a buffer to be filled
  'with a LANA_ENUM structure. NCBENUM is
  'not a standard NetBIOS 3.0 command.
   With ncb
      .ncb_command = NCBENUM
      .ncb_length = LenB(lana)
      .ncb_buffer = VarPtr(lana)
   End With
   
   Call Netbios(ncb)
   
  'instead of testing the return value of
  'the NetBIOS call as with other APIs, we
  'instead check the retcode member of the
  'NCB structure
   If ncb.ncb_retcode = NRC_GOODRET Then

     'prepare the array to receive
     'all MAC addresses, 0-based
      ReDim sMACAddresses(0 To lana.length - 1)
      
      For cnt = 0 To lana.length - 1
      
        'Reset the adapter - required
        'before it can accept any other
        'NCB command. The ncb_lana_num
        'member is assigned the next
        'lana number returned from the
        'NCBENUM call.
         With ncb
            .ncb_command = NCBRESET
            .ncb_lana_num = lana.adapter_numbers(cnt)
         End With
         
         Call Netbios(ncb)
         
         If ncb.ncb_retcode = NRC_GOODRET Then
           
           'To get the MAC address for an
           'ethernet adapter use send the
           'NCBASTAT command and provide
           '"*" as ncb_CallName (must be
           'formatted as a 16-chr string).
           'The same lana number is used.
            With ncb
               .ncb_command = NCBASTAT
               .ncb_lana_num = lana.adapter_numbers(cnt)
               .ncb_length = Len(ast)
               .ncb_callname = Space$(16)
               Mid$(.ncb_callname, 1, 1) = "*"
            End With
      
           'allocate memory for the ASTAT struct
            pASTAT = HeapAlloc(GetProcessHeap(), _
                               HEAP_GENERATE_EXCEPTIONS Or _
                               HEAP_ZERO_MEMORY, _
                               ncb.ncb_length)
                     
            If pASTAT <> 0 Then
   
              'assign the memory buffer to
              'the NCB buffer, call, and
              'copy the result to an AST type
               ncb.ncb_buffer = pASTAT
               Call Netbios(ncb)
            
               If ncb.ncb_retcode = NRC_GOODRET Then
            
                 'copy the info from the
                 'buffer into the UDT
                  CopyMemory ast, ncb.ncb_buffer, Len(ast)
              
                 'convert the byte array to a string
                  sMACAddresses(cnt) = MakeMacAddress(ast.adapt.adapter_address(), sDelimiter)
                  HeapFree GetProcessHeap(), 0, pASTAT
               
               End If  'ncb.ncb_retcode = NRC_GOODRET (NCBASTAT call)
         
            Else
               Debug.Print "HeapAlloc memory allcoation failed!"
            End If  'pastat
   
         End If  'ncb.ncb_retcode
   
      Next  'cnt
      
     'return number of adapters enumerated
      GetNBMacAddresses = lana.length
      
   End If  'ncb.ncb_retcode

End Function


Private Function MakeMacAddress(b() As Byte, sDelim As String) As String

   Dim cnt As Long
   Dim buff As String
   
   On Local Error GoTo MakeMac_error
 
  'so far, MAC addresses are
  'exactly 6 segments in size (0-5)
   If UBound(b) = 5 Then
   
     'concatenate the first five values
     'together and separate with the
     'delimiter char
      For cnt = 0 To 4
         buff = buff & Right$("00" & Hex(b(cnt)), 2) & sDelim
      Next
      
     'and append the last value
      buff = buff & Right$("00" & Hex(b(5)), 2)
         
   End If  'UBound(b)
   
   MakeMacAddress = buff
   
MakeMac_exit:
   Exit Function
   
MakeMac_error:
   MakeMacAddress = "(error building MAC address)"
   Resume MakeMac_exit
   
End Function
 Comments

 
 

PayPal Link
Make payments with PayPal - it's fast, free and secure!

 
 
 
 

Copyright 1996-2011 VBnet and Randy Birch. All Rights Reserved.
Terms of Use  |  Your Privacy

 

Hit Counter