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] [Next]