NetServerEnum2 or Net32ServerEnum2

The NetServerEnum2 API enumerates the set of all servers visible on the network. The type of NetServerEnum2 matches the bit mask in the field.

The NetServerEnum2 API replaces the NetServerEnum API, which is now obsolete.

Restrictions

LAN Server and OS/2 Warp Server Only

This API can be called from DLS and OS/2 workstations, but DLS workstations can only issue this call to a remote LAN Server workstation. This API does not have any access authority requirements.

Directory and Security Server Only

The NetServerEnum2 API now recognizes the //resdom syntax in the domain name field. When the return code is NERR_DCEError, the buffer will hold the text of the DCE error.

#include <netcons.h>
#include <server.h>
 
NetServerEnum2(pszServername, sLevel, buf,
               usBuflen, pusEntriesReturned,
               pusEntriesAvail, servertype,
               pszDomainName);       /* 16 bit */
 
Net32ServerEnum2(pszServername, ulLevel, buf,
               ulBuflen, pulEntriesReturned,
               pulEntriesAvail, servertype,
               pszDomainName);       /* 32 bit */

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

sLevel or ulLevel

server_info

Server Level 1

Server Level 2

servertype

_type

pusEntriesReturned

pusEntriesAvail

_type

pszDomainName

A NULL pointer for pszDomainName or a pointer to a null value specifies all of the domains that the requester is monitoring.

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_BAD_NETPATH Г 53 Г The network path cannot be found. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г 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_NetNotStarted Г 2102 Г The redirector NETWKSTA.200 has not Г
Г Г Г been started. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_ServerNotStarted Г 2114 Г The Server service has not been Г
Г Г Г started. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_WkstaNotStarted Г 2138 Г The Requester service has not been Г
Г Г Г started. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_BrowserNotStarted Г 2139 Г The requested information is not Г
Г Г Г available. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_InternalError Г 2140 Г An internal error has occurred. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_BadTransactConfig Г 2141 Г The server is not configured for Г
Г Г Г transactions. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_InvalidAPI Г 2142 Г The requested API is not supported on Г
Г Г Г the remote server. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_BrowserTableIncomplete Г 2319 Г The server table was initialized Г
Г Г Г incorrectly. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_NotLocalDomain Г 2320 Г This domain is not active on this com- Г
Г Г Г puter. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_InvalidComputer Г 2351 Г The specified computer name is not Г
Г Г Г valid. Г
РФФФФФФФФФФФФФФФФФФФФФФФФФФФФФСФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй

Other codes could be returned by the DosFsCtl function.

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

The NetServerEnum2 API can obtain only level 0 and level 1 data structures.

This API returns the list of servers in domains the requester is monitoring. Because of its efficiency, NetServerEnum2 is the preferred API to retrieve server names.

The requester maintains a list of servers started in the default domain, the logon domain, and any other domains the requester is configured to monitor. The default domain is specified by the DOMAIN field in the Requester section of the IBMLAN.INI file or by the /DOMAIN parameter on NET START REQUESTER.

The logon domain can be different from the default domain if the user selects a different domain at logon time. The requester can be configured to monitor up to four other domains by specifying these domains on the OTHDOMAINS parameter line in the IBMLAN.INI file or in the /OTHDOMAINS parameter on the NET START REQUESTER command.

The restrictions on the value of the DOMAIN parameter apply to the computer on which the NetServerEnum2 API actually is run ; that is, the local computer if the pszServername argument is NULL, or the named server if the pszServername argument is not NULL.

[Back]

[Next]