Server Category

The functions in the Server category enable remote administration tasks to be performed on a local or remote server

Function	Description
NetServerAdminCommand	Executes a command on a server.
NetServerDiskEnum	Retrieves a list of local disk drives on a server.
NetServerDiskEnum32	This function is the same as NetServerDiskEnum except that it uses 32-bit data structures, is RPC-based, and is resumable.
NetServerEnum2	Lists all visible servers of specified types in the specified domain.
NetServerGetInfo	Retrieves information about a specified server.
NetServerGetInfo32	This function is the same as NetServerGetInfo except that it uses 32-bit data structures, is RPC-based, and supports different information levels.
NetServerSetInfo	Sets the operating parameters for a server.
NetServerSetInfo32	This function is the same as NetServerSetInfo except that it uses 32-bit data structures, is RPC-based, and supports different information levels.

NetServerGetInfo and NetServerGetInfo32 retrieves information about specified servers.

Any member of an Administrators group on a local or remote server can perform administrative tasks on that server, controlling its operation, user access, and resource sharing.

Certain low-level parameters affecting a server’s operation, defined in the server’s Registry or lanman.ini file, can be examined and modified by calling the NetServerGetInfo, NetServerGetInfo32, NetServerSetInfo, and NetServerSetInfo32 functions.

Other changes in a server’s operation require execution of one of the Net commands (such as net use or net share). To execute a net command on a server, an application calls the NetServerAdminCommand function.

NetServerEnum2 lists all visible servers of specified types in the specified domains. To provide a list of local drives on a server, the application calls NetServerDiskEnum or NetServerDiskEnum32.

Server Category Data Structures

The NetServerSetInfo function uses server_info_1 or server_info_2 to set up a server or to reconfigure an existing server.

The NetServerGetInfo function returns configuration information at three levels (0, 1, and 2) as server_info_0 (server name only), server_info_1, and server_info_2.

The lists of server information returned by the NetServerEnum function are limited to level 0 or level 1.

The NetServerDiskEnum function returns a list of all disk drives on a server using the server_info_0 data structure.

The NetServerSetInfo32 function can set the following levels of information: 100, 101 and 102 are valid for all platforms. Levels 402, 403, 502, 503 are valid for the appropriate platform. In addition, the following levels, which can be used for setting individual parameters, are valid for the appropriate platforms: 1005, 1107, 1009 - 1010, 1016 - 1018, 1037 - 1043, 1501-1503, 1506, 1509-1516, 1518, 1520-1525, 1528-1530, 1533-1550, and 1552-1556.

The NetServerGetInfo32 function returns configuration information at following levels: 100, 101 and 102 are valid for all platforms. Levels 402, 403, 502, and 503 are valid for the appropriate platforms.

Note

The SERVER_INFO data structures were designed for Windows NT Server computers. Because there are differences in the configuration parameters between Advanced Server and Windows NT Server, only those parameters described in the following structures for which Advanced Server equivalents exist can be administered in Advanced Server.

Server Information (level 0)

The server_info_0 data structure has the following format:

struct server_info_0 {

char sv0_name[CNLEN + 1];

};

Within this structure, sv0_name is an ASCIIZ string containing the name of a server. CNLEN is defined in the netcons.h header file.

Server Information (level 1)

At level 1, NetServerEnum2, NetServerGetInfo, and NetServerSetInfo use the server_info_1 data structure, as follows:

struct server_info_1 {

char sv1_name[CNLEN + 1];

unsigned char sv1_version_major;

unsigned char sv1_version_minor;

unsigned long sv1_type;

char * sv1_comment;

};

Within this structure, the following parameters have been defined:

sv1_name is an ASCIIZ string containing the name of a server.

sv1_version_major specifies, in the least significant nibble (rightmost nibble) the major release version number of the Advanced Server software. The most significant nibble (leftmost nibble) specifies server type.

The bits have the following values:

Code	Value	Bits	Meaning
MAJOR_VERSION_MASK	0x0F	0-3	Major version number
	0x10	4-7	Unlimited server
	0x10	4-7	Limited server
	0x10	4-7	Peer server

The mask MAJOR_VERSION_MASK, defined in the server.h header file, should be used to ensure correct results.

sv1_version_minor is the minor release version number of the Advanced Server software.

sv1_type describes the type of software the computer is running, defined in the server.h file as follows:

Manifest	Value	Type of Software
SV_TYPE_WORKSTATION	0x00000001	Workstation
SV_TYPE_SERVER	0x00000002	Server
SV_TYPE_SQLSERVER	0x00000004	SQL server
SV_TYPE_DOMAIN_CTRL	0x00000008	Primary domain controller
SV_TYPE_DOMAIN_BAKCTRL	0x00000010	Backup domain controller
SV_TYPE_TIME_SOURCE	0x00000020	Time server
SV_TYPE_AFP	0x00000040	Apple File Protocol (AFP) service
SV_TYPE_NOVEL	0x00000080	Novell service
SV_TYPE_ALL	0xFFFFFFFF	All types of servers

sv1_comment, which can be NULL points to an ASCIIZ string containing a comment describing the server.

Server Information (level 2)

The server_info_2 data structure has the following format:

struct server_info_2 {

char sv2_name[CNLEN+1];

unsigned char sv2_version_major;

unsigned char sv2_version_minor;

unsigned long sv2_type;

char * sv2_comment;

unsigned long sv2_ulist_mtime;

unsigned long sv2_glist_mtime;

unsigned long sv2_alist_mtime;

unsigned short sv2_users;

unsigned short sv2_disc;

char * sv2_alerts;

unsigned short sv2_auditing;

unsigned short sv2_numadmin;

unsigned short sv2_lanmask;

unsigned short sv2_hidden;

unsigned short sv2_announce;

unsigned short sv2_anndelta;

char sv2_guestacct[LM20_UNLEN + 1];

unsigned char sv2_pad1;

char * sv2_userpath;

unsigned short sv2_chdevs;

unsigned short sv2_chdevq;

unsigned short sv2_chdevjobs;

unsigned short sv2_connections;

unsigned short sv2_shares;

unsigned short sv2_openfiles;

unsigned short sv2_sessopens;

unsigned short sv2_sessvcs;

unsigned short sv2_sessreqs;

unsigned short sv2_opensearch;

unsigned short sv2_activelocks;

unsigned short sv2_numreqbuf;

unsigned short sv2_sizreqbuf;

unsigned short sv2_numbigbuf;

unsigned short sv2_numfiletasks;

unsigned short sv2_alertsched;

unsigned short; sv2_erroralert

unsigned short; sv2_logonalert

unsigned short; sv2_accessalert

unsigned short sv2_diskalert;

unsigned short sv2_netioalert;

unsigned short sv2_maxauditsz;

char * sv2_srvheuristics;

};

Within this structure, the following parameters are defined:

sv2_name through sv2_comment are the same as the corresponding elements in the server_info_1 data structure. For a complete description, see Server Information (level 1).

sv2_ulist_mtime tells the last time (in seconds from 00:00:00, January 1, 1970) the user’s list for servers was modified.

sv2_glist_mtime tells the last time (in seconds from 00:00:00, January 1, 1970) the groups list for servers was modified.

sv2_alist_mtime tells the last time (in seconds from 00:00:00, January 1, 1970) the access control list for servers was modified.

sv2_users tells how many users are allowed on the server.

sv2_disc tells the auto-disconnect time (in minutes). A session is disconnected if it is idle longer than the time specified by sv2_disc . If the value of sv2_disc is SV_NODISC, auto-disconnect is not enabled.

sv2_alerts points to an ASCIIZ string containing the list of user-names on the server’s alert table. Spaces separate the names.

sv2_auditing specifies whether or not auditing is enabled on the server. If the value is 0, auditing is disabled.

sv2_numadmin specifies how many administrators a server can accommodate at the same time.

sv2_lanmask determines the order in which the network device drivers are served.

sv2_hidden determines whether the server is visible to other computers in the same network domain.

sv2_hidden is defined in the server.h file as follows:

Manifest	Value	Meaning
SV_VISIBLE	0	Server is visible.
SV_HIDDEN	1	Server is not visible.

sv2_announce specifies the network announce rate (in seconds) which determines how often the server is announced to other computers on the network.

sv2_anndelta specifies delta or change of the announce rate (in milliseconds). This value specifies how much the announce rate can vary from the time specified in sv2_announce. The delta value allows randomly varied announce rates. For example, if sv2_announce has the value 10 and sv2_anndelta has the value 1, the announce rate can vary from 9.999 seconds to 10.001 seconds.

sv2_guestacct is an ASCIIZ string containing the name of a server’s reserved guest user account.

LM20_UNLEN is defined in the netcons.h header file.

sv2_pad1 word-aligns the data structure components.

sv2_userpath points to an ASCIIZ string containing the path name to user directories.

sv2_chdevs specifies how many character devices can be shared on the server.

sv2_chdevq specifies how many character device queues can coexist on the server.

sv2_chdevjobs specifies how many character device jobs can be pending.

sv2_connections specifies how many connections to share names are allowed.

sv2_shares specifies how many share names a server can accommodate.

sv2_openfiles specifies how many files can be open at once.

sv2_sessopens specifies how many files can be open in one session.

sv2_sessvcs specifies the maximum number of virtual circuits per client.

sv2_sessreqs specifies how many simultaneous requests a client can make on any virtual circuit.

sv2_opensearch specifies how many searches can be open at once.

sv2_activelocks specifies how many file locks can be active at the same time.

sv2_numreqbuf specifies how many server buffers are provided.

sv2_sizreqbuf specifies the size (in bytes) of the request buffer that that the server uses.

sv2_numbigbuf specifies how many 64 KBytes server buffers are provided.

sv2_numfiletasks specifies how many processes can access the operating system at one time.

sv2_alertsched specifies the alert interval (in seconds) for notifying an administrator of a network event.

sv2_erroralert specifies how many entries can be written to the error log file during a sv2_alertsched interval before notifying an administrator.

sv2_logonalert specifies how many invalid logon attempts to allow a user before notifying an administrator.

sv2_accessalert specifies how many invalid file accesses to allow before notifying an administrator.

sv2_diskalert specifies at what point (how many KBytes of free disk space) to notify an administrator that a disk’s free space is low.

sv2_netioalert specifies the network I/O error ratio (in tenths of a percent) to allow before notifying an administrator.

sv2_maxauditsz specifies the maximum audit file size (in KBytes).

sv2_srvheuristics points to an ASCIIZ string of flags used to control a server’s operations.

Server Information (level 3)

The server_info_3 data structure has the following format:

struct server_info_3 {

char sv3_name[CNLEN+1];

unsigned char sv3_version_major;

unsigned char sv3_version_minor;

unsigned long sv3_type;

char * sv3_comment;

unsigned long sv3_ulist_mtime;

unsigned long sv3_glist_mtime;

unsigned long sv3_alist_mtime;

unsigned short sv3_users;

unsigned short sv3_disc;

char * sv3_alerts;

unsigned short sv3_security;

unsigned short sv3_auditing;

unsigned short sv3_numadmin;

unsigned short sv3_lanmask;

unsigned short sv3_hidden;

unsigned short sv3_announce;

unsigned short sv3_anndelta;

char sv3_guestacct[LM20_UNLEN+1];

unsigned char sv3_pad1;

char * sv3_userpath;

unsigned short sv3_chdevs;

unsigned short sv3_chdevq;

unsigned short sv3_chdevjobs;

unsigned short sv3_connections;

unsigned short sv3_shares;

unsigned short sv3_openfiles;

unsigned short sv3_sessopens;

unsigned short sv3_sessvcs;

unsigned short sv3_sessreqs;

unsigned short sv3_opensearch;

unsigned short sv3_activelocks;

unsigned short sv3_numreqbuf;

unsigned short sv3_sizreqbuf;

unsigned short sv3_numbigbuf;

unsigned short sv3_numfiletasks;

unsigned short sv3_alertsched;

unsigned short sv3_erroralert;

unsigned short sv3_logonalert;

unsigned short sv3_accessalert;

unsigned short sv3_diskalert;

unsigned short sv3_netioalert;

unsigned short sv3_maxauditsz;

char * sv3_srvheuristics;

unsigned long sv3_auditedevents;

unsigned short sv3_autoprofile;

char * sv3_autopath;

};

Within this structure, the following parameters are defined:

sv3_name through sv3_heuristics have the same definition as the corresponding fields in the server_info_2 structure. For a complete description, see Server Information (level 2).

sv3_auditedevents specifies the audit event control mask. Bits 18 through 31 are reserved. Bits 0 through 16 have the following meaning:

Event Name	Bit Mask	Meaning
service	0x0001	Disable audit of service state changes.
goodsesslogon	0x0006	Disable auditing of successful session logon requests.
badsesslogon	0x0018	Disable auditing of failed session logon requests.
sesslogon	0x001E	Disable auditing of all session logon/logoff attempts.
goodnetlogon	0x0060	Disable auditing of successful network logon requests.
badnetlogon	0x0180	Disable auditing of failed network logon requests.
netlogon	0x01E0	Disable auditing of all network logon/logoff attempts.
logon	0x01FE	Disable auditing of all logon/logoff attempts (network and session). This event produces the same effect as goodlog/badlog events.
gooduse	0x0600	Disable auditing of successful attempts to use a shared resource.
baduse	0x0800	Disable auditing of failed attempts to use a shared resource.
use	0x1E00	Disable auditing of all access requests to a shared resource regardless of gooduse or baduse masks. Produces the same effect as the gooduse/baduse masks.
userlist	0x2000	Disable auditing of changes to the user/domain database.
permissions	0x4000	Disable auditing of changes to the access control list (ACL).
resource	0x8000	Disable auditing of resource access as defined by the per-resource auditing options, specified in the access control list (ACL).
logonlimit	0x10000	Disable audit of logon limit violations.

sv3_autoprofile controls how the server acts on the profile. The server.h file defines these possible values:

Code	Value	Meaning
SW_AUTOPROF_LOAD_MASK	0x1	Server loads the profile.
SW_AUTOPROF_SAVE_MASK	0x2	Server saves the profile.

sv3_autopath points to the path name for the profile.

Server Information (level 100)

The SERVER_INFO_100 data structure has the following format:

typedef struct _SERVER_INFO_100 {

DWORD sv100_platform_id;

LPTSTR sv100_name;

} SERVER_INFO_100, *PSERVER_INFO_100, *LPSERVER_INFO_100;

Within this structure, sv100_platform_id identifies the platform on which the server is running.

sv100_name is an ASCIIZ string containing the name of the server.

Server Information (level 101)

The SERVER_INFO_101 data structure has the following format:

typedef struct _SERVER_INFO_101 {

DWORD sv101_platform_id;

LPTSTR sv101_name;

DWORD sv101_version_major;

DWORD sv101_version_minor;

DWORD sv101_type;

LPTSTR sv101_comment;

} SERVER_INFO_101, *PSERVER_INFO_101, *LPSERVER_INFO_101;

Within this structure, sv101_platform_id identifies the platform on which the server is running.

The remaining elements are the same as the corresponding elements in the server_info_1 data structure. For a complete description, see Server Information (level 1).

Server Information (level 102)

The SERVER_INFO_102 data structure has the following format:

typedef struct SERVER_INFO_102 {

DWORD sv102_platform_id;

LPTSTR sv102_name;

DWORD sv102_version_major;

DWORD sv102_version_minor;

DWORD sv102_type;

LPTSTR sv102_comment;

DWORD sv102_users;

DWORD sv102_disc;

BOOL sv102_hidden;

DWORD sv102_announce;

DWORD sv102_anndelta;

LPTSTR sv102_userpath;

} SERVER_INFO_102, *PSERVER_INFO_102, *LPSERVER_INFO_102;

Within this structure, sv102_platform_id identifies the platform on which the server is running.

The remaining elements are the same as the corresponding elements in the server_info_2 data structure. For a complete description, see Server Information (level 2).

Server Information (level 402)

The SERVER_INFO_402 data structure has the following format:

typedef struct _SERVER_INFO_402 {

DWORD sv402_ulist_mtime;

DWORD sv402_glist_mtime;

DWORD sv402_alist_mtime;

LPTSTR sv402_alerts;

DWORD sv402_security;

DWORD sv402_numadmin;

DWORD sv402_lanmask;

LPTSTR sv402_guestacct;

DWORD sv402_chdevs;

DWORD sv402_chdevq;

DWORD sv402_chdevjobs;

DWORD sv402_connections;

DWORD sv402_shares;

DWORD sv402_openfiles;

DWORD sv402_sessopens;

DWORD sv402_sessvcs;

DWORD sv402_sessreqs;

DWORD sv402_opensearch;

DWORD sv402_activelocks;

DWORD sv402_numreqbuf;

DWORD sv402_sizreqbuf;

DWORD sv402_numbigbuf;

DWORD sv402_numfiletasks;

DWORD sv402_alertsched;

DWORD sv402_erroralert;

DWORD sv402_logonalert;

DWORD sv402_accessalert;

DWORD sv402_diskalert;

DWORD sv402_netioalert;

DWORD sv402_maxauditsz;

LPTSTR sv402_srvheuristics;

} SERVER_INFO_402, *PSERVER_INFO_402, *LPSERVER_INFO_402;

Within this structure, all elements are the same as the corresponding elements in the server_info_3 data structure. For a complete description, see Server Information (level 3).

Server Information (level 403)

The SERVER_INFO_403 data structure has the following format:

typedef struct _SERVER_INFO_403 {

DWORD sv403_ulist_mtime;

DWORD sv403_glist_mtime;

DWORD sv403_alist_mtime;

LPTSTR sv403_alerts;

DWORD sv403_security;

DWORD sv403_numadmin;

DWORD sv403_lanmask;

LPTSTR sv403_guestacct;

DWORD sv403_chdevs;

DWORD sv403_chdevq;

DWORD sv403_chdevjobs;

DWORD sv403_connections;

DWORD sv403_shares;

DWORD sv403_openfiles;

DWORD sv403_sessopens;

DWORD sv403_sessvcs;

DWORD sv403_sessreqs;

DWORD sv403_opensearch;

DWORD sv403_activelocks;

DWORD sv403_numreqbuf;

DWORD sv403_sizreqbuf;

DWORD sv403_numbigbuf;

DWORD sv403_numfiletasks;

DWORD sv403_alertsched;

DWORD sv403_erroralert;

DWORD sv403_logonalert;

DWORD sv403_accessalert;

DWORD sv403_diskalert;

DWORD sv403_netioalert;

DWORD sv403_maxauditsz;

LPTSTR sv403_srvheuristics;

DWORD sv403_auditedevents;

DWORD sv403_autoprofile;

LPTSTR sv403_autopath;

} SERVER_INFO_403, *PSERVER_INFO_403, *LPSERVER_INFO_403;

Within this structure, all elements are the same as the corresponding elements in the server_info_3 data structure. For a complete description, see Server Information (level 3).

Server Information (level 502)

The SERVER_INFO_502 data structure has the following format:

typedef struct _SERVER_INFO_502 {

DWORD sv502_sessopens;

DWORD sv502_sessvcs;

DWORD sv502_opensearch;

DWORD sv502_sizreqbuf;

DWORD sv502_initworkitems;

DWORD sv502_maxworkitems;

DWORD sv502_rawworkitems;

DWORD sv502_irpstacksize;

DWORD sv502_maxrawbuflen;

DWORD sv502_sessusers;

DWORD sv502_sessconns;

DWORD sv502_maxpagedmemoryusage;

DWORD sv502_maxnonpagedmemoryusage;

BOOL sv502_enablesoftcompat;

BOOL sv502_enableforcedlogoff;

BOOL sv502_timesource;

BOOL sv502_acceptdownlevelapis;

BOOL sv502_lmannounce;

} SERVER_INFO_502, *PSERVER_INFO_502, *LPSERVER_INFO_502;

Within this structure, sv502_sessopens specifies the maximum number if files that can be open in one session.

sv502_sesssvcs specifies the maximum number of virtual circuits per client.

sv502_opensearch specifies how many searches can be open at once.

sv502_sizreqbuf specifies the size of request buffer that the server uses.

sv502_initworkitems specifies the initial number if receive buffers, or work items, used by the server.

sv502_maxworkitems specifies the maximum number of receive buffers, or work items, the server can allocate.

sv502_rawworkitems specifies the number of special work items for raw I/O that the server uses.

sv502_irpstacksize specifies the number of stack locations in I/O Request Packets (IRPs) used by the server.

sv502_maxrawbuflen specifies the maximum size of buffer used for raw I/O.

sv502_sessusers specifies the maximum number of users that can be logged on to a server via a single virtual circuit.

sv502_sessconns specifies the maximum number of tree connections that can be made on the server via a single virtual circuit.

sv502_maxpagedmemoryusage specifies the maximum size of pageable memory that the server can have allocated at any time.

sv502_maxnonpagedmemoryusage specifies the maximum size of nonpaged memory that the server can have allocated at any time.

sv502_enablesoftcompat specifies whether the server maps a request to a normal open request with shared-read access when the server receives a compatibility open request with read access. Mapping such requests allows several MS-DOS computers to open a single file for read access.

sv502_enableforcedlogoff specifies whether the forced logoff is enabled on the server.

sv502_timesource specifies whether the server can provide a timesource service.

sv502_acceptdownlevelapis specifies whether the server accepts down-level APIs.

sv502_lmannounce specifies whether lmannounce is supported.

Server Information (level 503)

The SERVER_INFO_503 data structure had the following format:

typedef struct _SERVER_INFO_503 {

DWORD sv503_sessopens;

DWORD sv503_sessvcs;

DWORD sv503_opensearch;

DWORD sv503_sizreqbuf;

DWORD sv503_initworkitems;

DWORD sv503_maxworkitems;

DWORD sv503_rawworkitems;

DWORD sv503_irpstacksize;

DWORD sv503_maxrawbuflen;

DWORD sv503_sessusers;

DWORD sv503_sessconns;

DWORD sv503_maxpagedmemoryusage;

DWORD sv503_maxnonpagedmemoryusage;

BOOL sv503_enablesoftcompat;

BOOL sv503_enableforcedlogoff;

BOOL sv503_timesource;

BOOL sv503_acceptdownlevelapis;

BOOL sv503_lmannounce;

LPTSTR sv503_domain;

DWORD sv503_maxcopyreadlen;

DWORD sv503_maxcopywritelen;

DWORD sv503_minkeepsearch;

DWORD sv503_maxkeepsearch;

DWORD sv503_minkeepcomplsearch;

DWORD sv503_maxkeepcomplsearch;

DWORD sv503_threadcountadd;

DWORD sv503_numblockthreads;

DWORD sv503_scavtimeout;

DWORD sv503_minrcvqueue;

DWORD sv503_minfreeworkitems;

DWORD sv503_xactmemsize;

DWORD sv503_threadpriority;

DWORD sv503_maxmpxct;

DWORD sv503_oplockbreakwait;

DWORD sv503_oplockbreakresponsewait;

BOOL sv503_enableoplocks;

BOOL sv503_enableoplockforceclose;

BOOL sv503_enablefcbopens;

BOOL sv503_enableraw;

BOOL sv503_enabledpc;

BOOL sv503_enablemdlio;

BOOL sv503_enablefastio;

} SERVER_INFO_503, *PSERVER_INFO_503, *LPSERVER_INFO_503;

Within this structure, the following parameters are defined:

sv503_sessopens through sv503_lmannounce are the same as the corresponding elements in the SERVER_INFO_502 data structure. For a complete description, see Share Information (level 502).

sv503_domain specifies the domain name of the server.

sv503_maxcopyreadlen specifies the maximum length of copy reads on the server.

sv503_maxcopywritelen specifies the maximum length of copy writes on the server.

sv503_minkeepsearch specifies the minimum time during which an incomplete MS-DOS search will be kept by the server.

sv503_maxkeepsearch specifies the maximum time during which an incomplete MS-DOS search will be kept by the server.

sv503_minkeepcomplsearch specifies the minimum time during which a complete MS-DOS search will be kept by the server.

sv503_maxkeepcomplsearch specifies the maximum time during which a complete MS-DOS search will be kept by the server.

sv503_threadcountadd indicates how many additional threads the server should use in addition to one worker thread per processor it already uses.

sv503_numblockthreads specifies the number of threads set aside by the server to service requests that can block the thread for a significant amount of time.

sv503_scavtimeout specifies the time that the scavenger remains idle before waking up to service requests.

sv503_minrcvqueue specifies the minimum number of free receive work items needed by the server before it begins allocating more.

sv503_minfreeworkitems specifies the minimum number of available receive work items that are needed for the server to process a potentially blocking SMB.

sv503_xactmemsize specifies the maximum amount of virtual memory used by the xactsrv service.

sv503_threadpriority specifies the priority of all server threads in relation to the base priority of the process.

sv503_maxmpxct provides a suggested maximum to clients for the number of simultaneous requests outstanding to this server.

sv503_oplockbreakwait specifies the time that the server waits for a client to respond to an oplock break request.

sv503_oplockbreakresponsewait specifies the time the server waits for a client to respond after the response to client’s request issued as a result of an oplock break request was sent.

sv503_enableoplocks specifies whether the server allows clients to use oplocks on files.

sv503_enableoplockforceclose specifies how the server should behave if a client has an opportunistic lock (oplock) and does not respond to an oplock break: whether it will fail the second open (0), or force close the open instance of a client that has an oplock (1).

sv503_enablefcbopens specifies whether File Control Blocks (FCBs) are folded together, so multiple resource opens are performed as a single open on the server.

sv503_enableraw specifies whether the server processes raw SMBs.

sv503_enabledpc specifies whether DPC is enabled on the server.

sv503_enablemdlio specifies whether Mdl I/O is enabled on the server.

sv503_enablefastio specifies whether Fast I/O is enabled on the server.

Server Information (level 599)

The SERVER_INFO_599 data structure has the following format:

typedef struct _SERVER_INFO_599 {

DWORD sv599_sessopens;

DWORD sv599_sessvcs;

DWORD sv599_opensearch;

DWORD sv599_sizreqbuf;

DWORD sv599_initworkitems;

DWORD sv599_maxworkitems;

DWORD sv599_rawworkitems;

DWORD sv599_irpstacksize;

DWORD sv599_maxrawbuflen;

DWORD sv599_sessusers;

DWORD sv599_sessconns;

DWORD sv599_maxpagedmemoryusage;

DWORD sv599_maxnonpagedmemoryusage;

BOOL sv599_enablesoftcompat;

BOOL sv599_enableforcedlogoff;

BOOL sv599_timesource;

BOOL sv599_acceptdownlevelapis;

BOOL sv599_lmannounce;

LPTSTR sv599_domain;

DWORD sv599_maxcopyreadlen;

DWORD sv599_maxcopywritelen;

DWORD sv599_minkeepsearch;

DWORD sv599_maxkeepsearch;

DWORD sv599_minkeepcomplsearch;

DWORD sv599_maxkeepcomplsearch;

DWORD sv599_threadcountadd;

DWORD sv599_numblockthreads;

DWORD sv599_scavtimeout;

DWORD sv599_minrcvqueue;

DWORD sv599_minfreeworkitems;

DWORD sv599_xactmemsize;

DWORD sv599_threadpriority;

DWORD sv599_maxmpxct;

DWORD sv599_oplockbreakwait;

DWORD sv599_oplockbreakresponsewait;

BOOL sv599_enableoplocks;

BOOL sv599_enableoplockforceclose;

BOOL sv599_enablefcbopens;

BOOL sv599_enableraw;

BOOL sv599_enablesharednetdrives;

DWORD sv599_minfreeconnections;

DWORD sv599_maxfreeconnections;

DWORD sv599_initsesstable;

DWORD sv599_initconntable;

DWORD sv599_initfiletable;

DWORD sv599_initsearchtable;

DWORD sv599_alertschedule;

DWORD sv599_errorthreshhold;

DWORD sv599_networkerrorthreshhold;

DWORD sv599_diskspacethreshhold;

DWORD sv599_diskconfiguration;

DWORD sv599_maxlinkdelay;

DWORD sv599_minlinkthroughput;

DWORD sv599_linkinfovalidtime;

DWORD sv599_scavqosinfoupdatetime;

DWORD sv599_maxworkitemidletime;

} SERVER_INFO_599, *PSERVER_INFO_599, *LPSERVER_INFO_599;

Within this structure, the following parameters are defined:

sv599_sessopens through sv599_enableraw are the same as the corresponding elements in the SERVER_INFO_503 data structure. For a complete description, see Server Information (level 503).

sv599_enablesharednetsrives specifies whether drives connected through NWCS (that is, Novell drives) should be re-shared as Windows NT shares if NWCS is installed. It does not allow re-sharing of Windows NT shares.

sv599_minfreeconnections specifies the minimum number of free connection blocks maintained per endpoint.

sv599_maxfreeconnections specifies the maximum number of free connection blocks maintained per endpoint.

sv599_initsesstable specifies the initial number of session entries to be allocated in the session table of each server connection.

sv599_initconntable specifies the initial number of tree connections to be allocated in the connection table.

sv599_initfiletable specifies the initial number of file entries to be allocated in the file table of each server connection.

sv599_initsearchtable specifies the initial number of entries in the connection’s search table.

sv599_alertschedule specifies how often the server checks alert conditions and sends needed alert messages.

sv599_errorthreshold specifies the number of errors that can occur within an sv599_alertschedule interval before the server sends an alert message.

sv599_networkerrorthreshold specifies the maximum percentage of failing network operations relative to total network operations allowed before an alert is triggered.

sv599_diskspacethreshold specifies the percentage of free disk space remaining before an alert is sent.

sv599_reserved is reserved for future use.

sv599_maxlinkdelay specifies the maximum time allowed for a link delay. If delays exceed this number, the server disables raw I/O on this connection.

sv599_minlinkthroughput specifies the minimum link throughput allowed by the server before it disables raw and opportunistic locks for this connection.

sv599_linkinfovalidtime specifies the amount of time during which the transport link information is still valid.

sv599_scavqosinfoupdatetime specifies the time that can pass before the scavenger goes through the list of active connections to update the link information.

sv599_maxworkitemsidletime specifies the amount of time that a work item can stay on the idle queue before it is freed.

The following info levels are only valid for NetServerSetInfo32 and replace the older way of passing in a parmnum to set a specific field.

The levels described in the following sections also are supported on down-level systems such as LAN Manager 2.x.

Server Information (level 1005)

The SERVER_INFO_1005 data structure has the following format:

typedef struct _SERVER_INFO_1005 {

LPTSTR sv1005_comment;

} SERVER_INFO_1005, *PSERVER_INFO_1005, *LPSERVER_INFO_1005;

Within this structure, sv1005_comment, which can be NULL, points to an ASCIIZ string containing a comment describing a server.

Server Information (level 1107)

The SERVER_INFO_1107 data structure has the followingformat:

typedef struct _SERVER_INFO_1107 {

DWORD sv1107_users;

} SERVER_INFO_1107, *PSERVER_INFO_1107, *LPSERVER_INFO_1107;

Within this structure, sv1107_users tells how many users are allowed on the server.

Server Information (level 1010)

The SERVER_INFO_1010 data structure has the following format:

typedef struct _SERVER_INFO_1010 {

DWORD sv1010_disc;

} SERVER_INFO_1010, *PSERVER_INFO_1010, *LPSERVER_INFO_1010;

Within this structure, sv1010_disc specifies the auto-disconnect time (in minutes). A session is disconnected if it is idle no longer than the time specified by sv1010_disc. If the value of sv1010_disc is SV_NODISC, auto-disconnect is not enabled.

Server Information (level 1016)

The SERVER_INFO_1016 data structure has the following format:

typedef struct _SERVER_INFO_1016 {

BOOL sv1016_hidden;

} SERVER_INFO_1016, *PSERVER_INFO_1016, *LPSERVER_INFO_1016;

Within this structure, sv1016_hidden determines whether the server is visible to other computers in the same network domain.

Server Information (level 1017)

The SERVER_INFO_1017 data structure has the following format:

typedef struct _SERVER_INFO_1017 {

DWORD sv1017_announce;

} SERVER_INFO_1017, *PSERVER_INFO_1017, *LPSERVER_INFO_1017;

Within this structure, sv1017_announce specifies the network announce rate (in seconds) which determines how often the server is announced to other computers on the network.

Server Information (level 1018)

The SERVER_INFO_1018 data structure has the following format:

typedef struct _SERVER_INFO_1018 {

DWORD sv1018_anndelta;

} SERVER_INFO_1018, *PSERVER_INFO_1018, *LPSERVER_INFO_1018;

Within this structure, sv1018_anndelta specifies delta or change in the announce rate (in milliseconds). This value specifies how much the announce rate can vary from the time specified in sv1017_announce. The delta value allows randomly varied announce rates.

Server Information (level 1037)

The SERVER_INFO_1037 data structure has the following format:

typedef struct _SERVER_INFO_1037 {

DWORD sv1037_alertsched;

} SERVER_INFO_1037, *PSERVER_INFO_1037, *LPSERVER_INFO_1037;

Within this structure, sv1037_alertsched specifies the alert interval (in seconds) for notifying an administrator of a network event.

Server Information (level 1038)

The SERVER_INFO_1038 data structure has the following format:

typedef struct _SERVER_INFO_1038 {

DWORD sv1038_erroralert;

} SERVER_INFO_1038, *PSERVER_INFO_1038, *LPSERVER_INFO_1038;

Within this structure, sv1038_erroralert specifies how many entries can be written to the error log file during a sv1037_alertsched interval before notifying an administrator.

Server Information (level 1039)

The SERVER_INFO_1039 data structure has the following format:

typedef struct _SERVER_INFO_1039 {

DWORD sv1039_logonalert;

} SERVER_INFO_1039, *PSERVER_INFO_1039, *LPSERVER_INFO_1039;

Within this structure, sv1039_logonalert specifies how many invalid logon attempts to allow a user before notifying an administrator.

Server Information (level 1040)

The SERVER_INFO_1040 data structure has the following format:

typedef struct _SERVER_INFO_1040 {

DWORD sv1040_accessalert;

} SERVER_INFO_1040, *PSERVER_INFO_1040, *LPSERVER_INFO_1040;

Within this structure, sv1040_accessalert specifies how many invalid file accesses to allow before notifying an administrator.

Server Information (level 1041)

The SERVER_INFO_1041 data structure has the following format:

typedef struct _SERVER_INFO_1041 {

DWORD sv1041_diskalert;

} SERVER_INFO_1041, *PSERVER_INFO_1041, *LPSERVER_INFO_1041;

Within this structure, sv1041_diskalert specifies at what point (how many KBytes of free disk space) to notify an administrator that a disk’s free space is low.

Server Information (level 1042)

The SERVER_INFO_1042 data structure has the following format:

typedef struct _SERVER_INFO_1042 {

DWORD sv1042_netioalert;

} SERVER_INFO_1042, *PSERVER_INFO_1042, *LPSERVER_INFO_1042;

Within this structure, sv1042_netioalert specifies the network I/O error ratio (in tenths of a percent) to allow before notifying an administrator.

Server Information (level 1043)

The SERVER_INFO_1043 data structure has the following format:

typedef struct _SERVER_INFO_1043 {

DWORD sv1043_maxauditsz;

} SERVER_INFO_1043, *PSERVER_INFO_1043, *LPSERVER_INFO_1043;

Within this structure, sv1043_maxauditsz specifies the maximum audit size file (in KBytes).

The following information levels are not supported on down-level systems such as LAN Manager 2.x because they cannot be modified "on the fly" on those systems.

Server Information (level 1009)

The SERVER_INFO_1009 data structure has the following format:

typedef struct _SERVER_INFO_1009 {

DWORD sv1009_users;

} SERVER_INFO_1009, *PSERVER_INFO_1009, *LPSERVER_INFO_1009;

Within this structure, sv1009_users specifies how many users are allowed on the server.

Server Information (level 1021)

The SERVER_INFO_1021 data structure has the following format:

typedef struct _SERVER_INFO_1021 {

LPTSTR sv1021_userpath;

} SERVER_INFO_1021, *PSERVER_INFO_1021, *LPSERVER_INFO_1021;

Within this structure, sv1021_userpath points to an ASCIIZ string containing the path name to user directories.

Server Information (level 1022)

The SERVER_INFO_1022 data structure has the following format:

typedef struct _SERVER_INFO_1022 {

DWORD sv1022_chdevs;

} SERVER_INFO_1022, *PSERVER_INFO_1022, *LPSERVER_INFO_1022;

Within this structure, sv1022_chdevs specifies how many character devices can be shared on the server.

The following information levels are not supported on down-level systems such as LAN Manager 2.x because these are Windows NT-only fields.

Server Information (level 1501)

The SERVER_INFO_1501 data structure has the following format:

typedef struct _SERVER_INFO_1501 {

DWORD sv1501_sessopens;

} SERVER_INFO_1501, *PSERVER_INFO_1501, *LPSERVER_INFO_1501;

Within this structure, sv1501_sessopens specifies how many files can be open in one session.

Server Information (level 1502)

The SERVER_INFO_1502 data structure has the following format:

typedef struct _SERVER_INFO_1502 {

DWORD sv1502_sessvcs;

} SERVER_INFO_1502, *PSERVER_INFO_1502, *LPSERVER_INFO_1502;

Within this structure, sv1502_sesssvcs specifies the maximum number of virtual circuits per client.

Server Information (level 1503)

The SERVER_INFO_1503 data structure has the following format:

typedef struct _SERVER_INFO_1503 {

DWORD sv1503_opensearch;

} SERVER_INFO_1503, *PSERVER_INFO_1503, *LPSERVER_INFO_1503;

Within this structure, sv1503_opensearch specifies the maximum number of outstanding searches on the server, per connection.

Server Information (level 1506)

The SERVER_INFO_1506 data structure has the following format:

typedef struct _SERVER_INFO_1506 {

DWORD sv1506_maxworkitems;

} SERVER_INFO_1506, *PSERVER_INFO_1506, *LPSERVER_INFO_1506;

Within this structure, sv1506_maxworkitems specifies the maximum number of receive buffers, or work items, the server can allocate.

Server Information (level 1509)

The SERVER_INFO_1509 data structure has the following format:

typedef struct _SERVER_INFO_1509 {

DWORD sv1509_maxrawbuflen;

} SERVER_INFO_1509, *PSERVER_INFO_1509, *LPSERVER_INFO_1509;

Within this structure, sv1509_maxrawbuflen specifies the maximum size of buffer used for raw I/O.

Server Information (level 1510)

The SERVER_INFO_1510 data structure has the following format:

typedef struct _SERVER_INFO_1510 {

DWORD sv1510_sessusers;

} SERVER_INFO_1510, *PSERVER_INFO_1510, *LPSERVER_INFO_1510;

Within this structure, sv1510_sessusers specifies the maximum number of users that can be logged on to a server via a single virtual circuit.

Server Information (level 1511)

The SERVER_INFO_1511 data structure has the following format:

typedef struct _SERVER_INFO_1511 {

DWORD sv1511_sessconns;

} SERVER_INFO_1511, *PSERVER_INFO_1511, *LPSERVER_INFO_1511;

Within this structure, sv1511_sessconns specifies the maximum number of tree connections that can be made on the server via a single virtual circuit.

Server Information (level 1512)

The SERVER_INFO_1512 data structure has the following format:

typedef struct _SERVER_INFO_1512 {

DWORD sv1512_maxnonpagedmemoryusage;

} SERVER_INFO_1512, *PSERVER_INFO_1512, *LPSERVER_INFO_1512;

Within this structure, sv1512_maxnonpagedmemoryusage specifies the maximum size of nonpaged memory that the server can have allocated at any time.

Server Information (level 1513)

The SERVER_INFO_1513 data structure has the following format:

typedef struct _SERVER_INFO_1513 {

DWORD sv1513_maxpagedmemoryusage;

} SERVER_INFO_1513, *PSERVER_INFO_1513, *LPSERVER_INFO_1513;

Within this structure, sv1513_maxpagedmemoryusage specifies the maximum size of pageable memory that the server can have allocated at any time.

Server Information (level 1514)

The SERVER_INFO_1514 data structure has the following format:

typedef struct _SERVER_INFO_1514 {

BOOL sv1514_enablesoftcompat;

} SERVER_INFO_1514, *PSERVER_INFO_1514, *LPSERVER_INFO_1514;

Within this structure, sv1514_enablesoftcompat specifies whether the server maps a request to a normal open request with shared-read access when the server receives a compatibility open request with read access. Mapping such requests allows several MS-DOS computers to open a single file for read access.

Server Information (level 1515)

The SERVER_INFO_1515 data structure has the following format:

typedef struct _SERVER_INFO_1515 {

BOOL sv1515_enableforcedlogoff;

} SERVER_INFO_1515, *PSERVER_INFO_1515, *LPSERVER_INFO_1515;

Within this structure, sv1515_enableforcedlogoff specifies whether the forced logoff is enabled on the server.

Server Information (level 1516)

The SERVER_INFO_1516 data structure has the following format:

typedef struct _SERVER_INFO_1516 {

BOOL sv1516_timesource;

} SERVER_INFO_1516, *PSERVER_INFO_1516, *LPSERVER_INFO_1516;

Within this structure, sv1516_timesource specifies whether the server provides timesource service.

Server Information (level 1518)

The SERVER_INFO_1518 data structure has the following format:

typedef struct _SERVER_INFO_1518 {

BOOL sv1518_lmannounce;

} SERVER_INFO_1518, *PSERVER_INFO_1518, *LPSERVER_INFO_1518;

Within this structure, sv1518_lmannounce specifies whether the server supports lmannounce.

Server Information (level 1520)

The SERVER_INFO_1520 data structure has the following format:

typedef struct _SERVER_INFO_1520 {

DWORD sv1520_maxcopyreadlen;

} SERVER_INFO_1520, *PSERVER_INFO_1520, *LPSERVER_INFO_1520;

Within this structure, sv1520_maxcopyreadlen specifies the maximum length of copy reads on the server.

Server Information (level 1521)

The SERVER_INFO_1521 data structure has the following format:

typedef struct _SERVER_INFO_1521 {

DWORD sv1521_maxcopywritelen;

} SERVER_INFO_1521, *PSERVER_INFO_1521, *LPSERVER_INFO_1521;

Within this structure, sv1521_maxsopywritelen specifies the maximum length of copy writes on the server.

Server Information (level 1522)

The SERVER_INFO_1522 data structure has the following format:

typedef struct _SERVER_INFO_1522 {

DWORD sv1522_minkeepsearch;

} SERVER_INFO_1522, *PSERVER_INFO_1522, *LPSERVER_INFO_1522;

Within this structure, sv1522_minkeepsearch specifies the minimum amount of time that the server will keep incomplete MS-DOS searches, even if more search entries are needed.

Server Information (level 1523)

The SERVER_INFO_1523 data structure has the following format:

typedef struct _SERVER_INFO_1523 {

DWORD sv1523_maxkeepsearch;

} SERVER_INFO_1523, *PSERVER_INFO_1523, *LPSERVER_INFO_1523;

Within this structure, sv1523_maxkeepsearch specifies the maximum time during which an incomplete MS-DOS search will be kept by the server.

Server Information (level 1524)

The SERVER_INFO_1524 data structure has the following format:

typedef struct _SERVER_INFO_1524 {

DWORD sv1524_minkeepcomplsearch;

} SERVER_INFO_1524, *PSERVER_INFO_1524, *LPSERVER_INFO_1524;

Within this structure, sv1524_minkeepcomplsearch specifies the minimum time during which a complete MS-DOS search will be kept by the server.

Server Information (level 1525)

The SERVER_INFO_1525 data structure has the following format:

typedef struct _SERVER_INFO_1525 {

DWORD sv1525_maxkeepcomplsearch;

} SERVER_INFO_1525, *PSERVER_INFO_1525, *LPSERVER_INFO_1525;

Within this structure, sv1525_maxkeepcomplsearch specifies the maximum time during which a complete MS-DOS search will be kept by the server.

Server Information (level 1528)

The SERVER_INFO_1528 data structure has the following format:

typedef struct _SERVER_INFO_1528 {

DWORD sv1528_scavtimeout;

} SERVER_INFO_1528, *PSERVER_INFO_1528, *LPSERVER_INFO_1528;

Within this structure, sv1528_scavtimeout specifies the time that the scavenger remains idle before waking up to service requests.

Server Information (level 1529)

The SERVER_INFO_1529 data structure has the following format:

typedef struct _SERVER_INFO_1529 {

DWORD sv1529_minrcvqueue;

} SERVER_INFO_1529, *PSERVER_INFO_1529, *LPSERVER_INFO_1529;

Within this structure, sv1529_minrcvqueue specifies the minimum number of free receive work items needed by the server before it begins allocating more.

Server Information (level 1530)

The SERVER_INFO_1530 data structure has the following format:

typedef struct _SERVER_INFO_1530 {

DWORD sv1530_minfreeworkitems;

} SERVER_INFO_1530, *PSERVER_INFO_1530, *LPSERVER_INFO_1530;

Within this structure, sv1530_minfreeworkitems specifies the minimum number of available receive work items that are needed for the server to begin processing a potentially blocking SMB.

Server Information (level 1533)

The SERVER_INFO_1533 data structure has the following format:

typedef struct _SERVER_INFO_1533 {

DWORD sv1533_maxmpxct;

} SERVER_INFO_1533, *PSERVER_INFO_1533, *LPSERVER_INFO_1533;

Within this structure, sv1533_maxmpxct provides a suggested maximum to clients for the number of simultaneous requests outstanding to this server.

Server Information (level 1534)

The SERVER_INFO_1534 data structure has the following format:

typedef struct _SERVER_INFO_1534 {

DWORD sv1534_oplockbreakwait;

} SERVER_INFO_1534, *PSERVER_INFO_1534, *LPSERVER_INFO_1534;

Within this structure, sv1534_oplockbreakwait specifies the time that the server waits for a client to respond to an oplock break request.

Server Information (level 1535)

The SERVER_INFO_1535 data structure has the following format:

typedef struct _SERVER_INFO_1535 {

DWORD sv1535_oplockbreakresponsewait;

} SERVER_INFO_1535, *PSERVER_INFO_1535, *LPSERVER_INFO_1535;

Within this structure, sv1535_oplockbreakresponsewait specifies the time the server waits for a client to respond after the response to client’s request issued as a result of an oplock break request was sent.

Server Information (level 1536)

The SERVER_INFO_1536 data structure has the following format:

typedef struct _SERVER_INFO_1536 {

BOOL sv1536_enableoplocks;

} SERVER_INFO_1536, *PSERVER_INFO_1536, *LPSERVER_INFO_1536;

Within this structure, sv1536_enableoplocks specifies whether the server allows clients to use oplocks on files.

Server Information (level 1537)

The SREVER_INFO_1537 data structure has the following format:

typedef struct _SERVER_INFO_1537 {

BOOL sv1537_enableoplockforceclose;

} SERVER_INFO_1537, *PSERVER_INFO_1537, *LPSERVER_INFO_1537;

Within this structure, sv1537_enableoplockforceclose specifies how the server should behave if a client has an opportunistic lock (oplock) and does not respond to an oplock break: whether it will fail the second open (0), or force close the open instance of a client that has an oplock (1).

Server Information (level 1538)

The SERVER_INFO_1538 data structure has the following format:

typedef struct _SERVER_INFO_1538 {

BOOL sv1538_enablefcbopens;

} SERVER_INFO_1538, *PSERVER_INFO_1538, *LPSERVER_INFO_1538;

Within this structure, sv1538_enablefcbopens specifies whether File Control Blocks (FCBs) are folded together, so multiple resource opens are performed as a single open on the server.

Server Information (level 1539)

The SERVER_INFO_1539 data structure has the following format:

typedef struct _SERVER_INFO_1539 {

BOOL sv1539_enableraw;

} SERVER_INFO_1539, *PSERVER_INFO_1539, *LPSERVER_INFO_1539;

Within this structure, sv1539_enableraw specifies whether the server processes raw SMBs.

Server Information (level 1540)

The SERVER_INFO_1540 data structure has the following format:

typedef struct _SERVER_INFO_1540 {

BOOL sv1540_enablesharednetdrives;

} SERVER_INFO_1540, *PSERVER_INFO_1540, *LPSERVER_INFO_1540;

Within this structure, sv1540_enablesharednetsrives specifies whether drives connected through NWCS (Novell drives) should be re-shared as Windows NT shares if NWCS is installed. It does not allow re-sharing of Windows NT shares.

Server Information (level 1541)

The SERVER_INFO_1541 data structure has the followingformat:

typedef struct _SERVER_INFO_1541 {

BOOL sv1541_minfreeconnections;

} SERVER_INFO_1541, *PSERVER_INFO_1541, *LPSERVER_INFO_1541;

Within this structure, sv1541_minfreeconnections specifies the minimum number of free connection blocks maintained per endpoint.

Server Information (level 1542)

The SERVER_INFO_1542 data structure has the following format:

typedef struct _SERVER_INFO_1542 {

BOOL sv1542_maxfreeconnections;

} SERVER_INFO_1542, *PSERVER_INFO_1542, *LPSERVER_INFO_1542;

Within this structure, sv1542_maxfreeconnections specifies the maximum number of free connection blocks maintained per endpoint.

Server Information (level 1543)

The SERVER_INFO_1543 data structure has the following format:

typedef struct _SERVER_INFO_1543 {

DWORD sv1543_initsesstable;

} SERVER_INFO_1543, *PSERVER_INFO_1543, *LPSERVER_INFO_1543;

Within this structure, sv1543_initsesstable specifies the initial number of session entries to be allocated in the session table of each server connection.

Server Information (level 1544)

The SERVER_INFO_1544 data structure has the following format:

typedef struct _SERVER_INFO_1544 {

DWORD sv1544_initconntable;

} SERVER_INFO_1544, *PSERVER_INFO_1544, *LPSERVER_INFO_1544;

Within this structure, sv1544_initconntable specifies the initial number of tree connections to be allocated in the connection table.

Server Information (level 1545)

The SERVER_INFO_1545 data structure has the following format:

typedef struct _SERVER_INFO_1545 {

DWORD sv1545_initfiletable;

} SERVER_INFO_1545, *PSERVER_INFO_1545, *LPSERVER_INFO_1545;

Within this structure, sv1545_initfiletable specifies the initial number of file entries to be allocated in the file table of each server connection.

Server Information (level 1546)

The SERVER_INFO_1546 data structure has the following format:

typedef struct _SERVER_INFO_1546 {

DWORD sv1546_initsearchtable;

} SERVER_INFO_1546, *PSERVER_INFO_1546, *LPSERVER_INFO_1546;

Within this structure, sv1546_initsearchtable specifies the initial number of entries in the connection’s search table.

Server Information (level 1547)

The SERVER_INFO_1547 data structure has the following format:

typedef struct _SERVER_INFO_1547 {

DWORD sv1547_alertschedule;

} SERVER_INFO_1547, *PSERVER_INFO_1547, *LPSERVER_INFO_1547;

Within this structure, sv1547_alertschedule specifies how often the server checks alert conditions and sends needed alert messages.

Server Information (level 1548)

The SERVER_INFO_1548 data structure has the following format:

typedef struct _SERVER_INFO_1548 {

DWORD sv1548_errorthreshhold;

} SERVER_INFO_1548, *PSERVER_INFO_1548, *LPSERVER_INFO_1548;

Within this structure, sv1548_errorthreshold specifies the number of errors that can occur within an sv1549_alertschedule interval before the server sends an alert message.

Server Information (level 1549)

The SERVER_INFO_1549 data structure has the following format:

typedef struct _SERVER_INFO_1549 {

DWORD sv1549_networkerrorthreshhold;

} SERVER_INFO_1549, *PSERVER_INFO_1549, *LPSERVER_INFO_1549;

Within this structure, sv1549_networkerrorthreshold specifies the maximum percentage of failing network operations relative to total network operations allowed before an alert is triggered.

Server Information (level 1550)

The SERVER_INFO_1550 data structure has the following format:

typedef struct _SERVER_INFO_1550 {

DWORD sv1550_diskspacethreshhold;

} SERVER_INFO_1550, *PSERVER_INFO_1550, *LPSERVER_INFO_1550;

Within this structure, sv1550_diskspacethreshold specifies the percentage of free disk space remaining before an alert is sent.

Server Information (level 1552)

The SERVER_INFO_1552 data structure has the following format:

typedef struct _SERVER_INFO_1552 {

DWORD sv1552_maxlinkdelay;

} SERVER_INFO_1552, *PSERVER_INFO_1552, *LPSERVER_INFO_1552;

Within this structure, sv1552_maxlinkdelay specifies the maximum time allowed for a link delay. If delays exceed this number, the server disables raw I/O on this connection.

Server Information (level 1553)

The SERVER_INFO_1553 data structure has the following format:

typedef struct _SERVER_INFO_1553 {

DWORD sv1553_minlinkthroughput;

} SERVER_INFO_1553, *PSERVER_INFO_1553, *LPSERVER_INFO_1553;

Within this structure, sv1553_minlinkthroughput specifies the minimum link throughput allowed by the server before it disables raw and opportunistic locks for this connection.

Server Information (level 1554)

The SERVER_INFO_1554 data structure has the following format:

typedef struct _SERVER_INFO_1554 {

DWORD sv1554_linkinfovalidtime;

} SERVER_INFO_1554, *PSERVER_INFO_1554, *LPSERVER_INFO_1554;

Within this structure, sv1554_linkinfovalidtime specifies the amount of time during which the transport link information is still valid.

Server Information (level 1555)

The SERVER_INFO_1555 data structure has the followingformat:

typedef struct _SERVER_INFO_1555 {

DWORD sv1555_scavqosinfoupdatetime;

} SERVER_INFO_1555, *PSERVER_INFO_1555, *LPSERVER_INFO_1555;

Within this structure, sv1555_scavqosinfoupdatetime specifies the time that can pass before the scavenger goes through the list of active connections to update the link information.

Server Information (level 1556)

The SERVER_INFO_1556 data structure has the following format:

typedef struct _SERVER_INFO_1556 {

DWORD sv1556_maxworkitemidletime;

} SERVER_INFO_1556, *PSERVER_INFO_1556, *LPSERVER_INFO_1556;

Within this structure, sv1556_maxworkitemsidletime specifies the amount of time that a work item can stay on the idle queue before it is freed.

For NetServerSetInfo32, parmnum values refer to the fields in the SERVER_INFO structures as follows. These values are used when indicating an error in a specific parameter via parm_err.

parmnum value	Field in server_info struct
SV_NAME_PARMNUM	sv_name
SV_VERSION_MAJOR_PARMNUM	sv_version_major
SV_VERSION_MINOR_PARMNUM	sv_version_minor
SV_TYPE_PARMNUM	sv_type
SV_COMMENT_PARMNUM	sv_comment
SV_USERS_PARMNUM	sv_users
SV_DISC_PARMNUM	sv_disc
SV_HIDDEN_PARMNUM	sv_hidden
SV_ANNOUNCE_PARMNUM	sv_announce
SV_ANNDELTA_PARMNUM	sv_anndelta
SV_USERPATH_PARMNUM	sv_userpath
SV_ULIST_MTIME_PARMNUM	sv_ulist_mtime
SV_GLIST_MTIME_PARMNUM	sv_glist_mtime
SV_ALIST_MTIME_PARMNUM	sv_alist_mtime
SV_ALERTS_PARMNUM	sv_alerts
SV_SECURITY_PARMNUM	sv_security
SV_NUMADMIN_PARMNUM	sv_numadmin
SV_LANMASK_PARMNUM	sv_lanmask
SV_GUESTACC_PARMNUM	sv_guestacc
SV_CHDEVS_PARMNUM	sv_chdevs
SV_CHDEVQ_PARMNUM	sv_chdevq
SV_CHDEVJOBS_PARMNUM	sv_chdevjobs
SV_CONNECTIONS_PARMNUM	sv_connections
SV_SHARES_PARMNUM	sv_shares
SV_OPENFILES_PARMNUM	sv_openfiles
SV_SESSOPENS_PARMNUM	sv_sessopens
SV_SESSVCS_PARMNUM	sv_sessvcs
SV_SESSREQS_PARMNUM	sv_sessreqs
SV_OPENSEARCH_PARMNUM	sv_opensearch
SV_ACTIVELOCKS_PARMNUM	sv_activelocks
SV_NUMREQBUF_PARMNUM	sv_numreqbuf
SV_SIZREQBUF_PARMNUM	sv_sizreqbuf
SV_NUMBIGBUF_PARMNUM	sv_numbigbuf
SV_NUMFILETASKS_PARMNUM	sv_numfiletasks
SV_ALERTSCHED_PARMNUM	sv_alertsched
SV_ERRORALERT_PARMNUM	sv_erroralert
SV_LOGONALERT_PARMNUM	sv_logonalert
SV_ACCESSALERT_PARMNUM	sv_accessalert
SV_DISKALERT_PARMNUM	sv_diskalert
SV_NETIOALERT_PARMNUM	sv_netioalert
SV_MAXAUDITSZ_PARMNUM	sv_maxauditsz
SV_SRVHEURISTICS_PARMNUM	sv_srvheuristics
SV_AUDITEDEVENTS_PARMNUM	sv_auditedevents
SV_AUTOPROFILE_PARMNUM	sv_autoprofile
SV_MAXWORKITEMS_PARMNUM	sv_maxworkitems
SV_RAWWORKITEMS_PARMNUM	sv_rawworkitems
SV_IRPSTACKSIZE_PARMNUM	sv_irpstacksize
SV_SESSUSERS_PARMNUM	sv_sessusers
SV_SESSCONNS_PARMNUM	sv_sessconns
SV_MAXNONPAGEDMEMORYUSAGE _PARMNUM	sv_maxnonpagedmemoryusage
SV_MAXPAGEDMEMORYUSAGE _PARMNUM	sv_maxpagedmmeoryusage
SV_ENABLEOFTCOMPAT_PARMNUM	sv_enablesoftcompat
SV_ENABLEFORCEDLOGOFF_PARMNUM	sv_enableforcedlogoff
SV_TIMESOURCE_PARMNUM	sv_timesource
SV_ACCEPTDOWNLEVELAPIS_PARMNUM	sv_acceptdownlevelapis
SV_LMANNOUNCE_PARMNUM	sv_lmannounce
SV_DOMAIN_PARMNUM	sv_domain
SV_MAXCOPYREADLEN_PARMNUM	sv_maxcopyreadlen
SV_MAXCOPYWRITELEN_PARMNUM	sv_maxcopywritelen
SV_MINKEEPSEARCH_PARMNUM	sv_minkeepsearch
SV_MAXKEEPSEARCH_PARMNUM	sv_maxkeepsearch
SV_MINKEEPCOMPLSEARCH_PARMNUM	sv_minkeepcopmlsearch
SV_MAXKEEPCOMPLSEARCH_PARMNUM	sv_maxkeepcomplsearch
SV_THREADCOUNTADD_PARMNUM	sv_threadcountadd
SV_NUMBLOCKTHREADS_PARMNUM	sv_numblockthreads
SV_SCAVTIMEOUT_PARMNUM	sv_scavtimeout
SV_MINRCVQUEUE_PARMNUM	sv_minrcvqueue
SV_MINFREEWORKITEMS_PARMNUM	sv_minfreeworkitems
SV_XACTMEMSIZE_PARMNUM	sv_xactmemsize
SV_THREADPRIORITY_PARMNUM	sv_threadpriority
SV_MAXMPXCT_PARMNUM	sv_maxmpxct
SV_OPLOCKBREAKWAIT_PARMNUM	sv_oplockbreakwait
SV_OPLOCKBREAKRESPONSEWAIT _PARMNUM	sv_oplockbreakresponsewait
SV_ENABLEOPLOCKS_PARMNUM	sv_enableoplocks
SV_ENABLEOPLOCKFORCECLOSE _PARMNUM	sv_enableoplockforceclose
SV_ENABLEFCBOPENS_PARMNUM	sv_enablefcbopens
SV_ENABLERAW_PARMNUM	sv_enableraw
SV_ENABLESHAREDNETDRIVES _PARMNUM	sv_enablesharednetdrives
SV_MINFREECONNECTIONS_PARMNUM	sv_minfreeconnections
SV_MAXFREECONNECTIONS_PARMNUM	sv_maxfreeconnections
SV_INITSESSTABLE_PARMNUM	sv_initsesstable
SV_INITCONNTABLE_PARMNUM	sv_initconntable
SV_INITFILETABLE_PARMNUM	sv_initfiletable
SV_INITSEARCHTABLE_PARMNUM	sv_initsearchtable
SV_ALERTSCHEDULE_PARMNUM	sv_alertschedule
SV_ERRORTHRESHHOLD_PARMNUM	sv_errorthreshold
SV_NETWORKERRORTHRESHOLD _PARMNUM	sv_networkerrorthreshold
SV_DISKSPACETHRESHHOLD_PARMNUM	sv_diskspacethreshold
SV_DISKCONFIGURATION_PARMNUM	sv_reserved
SV_MAXLINKDELAY_PARMNUM	sv_maxlinkdelay
SV_MINLINKTHROUGHPUT_PARMNUM	sv_minlinkthroughput
SV_LINKINFOVALIDTIME_PARMNUM	sv_linkinfovalidtime
SV_SCAVQOSINFOUPDATETIME _PARMNUM	sv_scavqosinfoupdatetime
SV_MAXWORKITEMIDLETIME _PARMNUM	sv_maxworkitemidletime