NetBiosGetInfo or NetBios32GetInfo

The NetBiosGetInfo API returns information about a particular network device driver installed on a computer.

Restrictions

This API can be called only from an OS/2 workstation.

Syntax

 
#include <netcons.h>
#include <ncb.h>
#include <netbios.h>
 
NetBiosGetInfo(pszServername, netbiosname,
               sLevel, buf, usBuflen
               pusBytesAvail);        /* 16 bit */
 
NetBios32GetInfo(pszServername, netbiosname,
               ulLevel, buf, ulBuflen
               pulBytesAvail);        /* 32 bit */

Parameters

See Common Parameter Definitions for descriptions of parameters not defined here.

netbiosname

(const unsigned char LSFAR *) points to an ASCIIZ string containing the name of the network, such as net1.
sLevel or ulLevel
(16-bit short or 32-bit unsigned long) can be 0 or 1, specifies the level of detail requested for the returned data structures. (See NetBIOS Level 0 and NetBIOS Level 1.)
Return Codes

The following table lists the return codes most significant to this API. (See API Return Codes for a complete list of return codes.) ┌─────────────────────────────┬───────┬────────────────────────────────────────┐│SYMBOLICCONSTANT │VALUE│MEANING │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_Success │ 0 │ No errors were encountered. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ ERROR_ACCESS_DENIED │ 5 │ Administrator privilege is required. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ ERROR_INVALID_LEVEL │ 124 │ The sLevel parameter is not valid. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ ERROR_MORE_DATA │ 234 │ Additional data is available, but the │
│ │ │ buffer is too small. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_BufTooSmall │ 2123 │ The buffer is too small for fixed- │
│ │ │ length data. │
├─────────────────────────────┼───────┼────────────────────────────────────────┤
│ NERR_InvalidComputer │ 2351 │ The specified computer name is not │
│ │ │ valid. │
└─────────────────────────────┴───────┴────────────────────────────────────────┘


Remarks

If you call this API with the buffer length parameter equal to zero, the API returns a value for total bytes available. This technique is useful if you do not know the exact buffer size required.

---

[Back: NetBiosEnum or NetBios32Enum]
[Next: NetBiosOpen or NetBios32Open]