SERVER_INFO_503

The SERVER_INFO_503 structure contains information about the specified server, including name, platform, type of server, and associated software.

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_enableforcedlogoff;
BOOL sv503_timesource;
BOOL sv503_acceptdownlevelapis;
BOOL sv503_lmannounce;
LPTSTR sv503_domain;
DWORD sv503_maxkeepsearch;
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_enablefcbopens;
BOOL sv503_enableraw;
BOOL sv503_enablesharednetdrives;
DWORD sv503_minfreeconnections;
DWORD sv503_maxfreeconnections;
} SERVER_INFO_503, *PSERVER_INFO_503, *LPSERVER_INFO_503;

Members

sv503_sessopens

Specifies the number of files that can be open in one session.

sv503_sessvcs

Specifies the maximum number of virtual circuits per client.

sv503_opensearch

Specifies the number of search operations that can be carried out simultaneously.

sv503_sizreqbuf

Specifies the size, in bytes, of each server buffer.

sv503_initworkitems

Specifies the initial number of receive buffers, or work items, used by the server. Allocating work items costs a certain amount of memory initially, but not as much as having to allocate additional buffers later.

sv503_maxworkitems

Specifies the maximum number of receive buffers, or work items, the server can allocate. If this limit is reached, the transport must initiate flow control at a significant performance cost.

sv503_rawworkitems

Specifies the number of special work items for raw I/O that the server uses. A larger value for this member can increase performance but costs more memory.

sv503_irpstacksize

Specifies the number of stack locations in IRPs allocated by the server.

sv503_maxrawbuflen

Specifies the maximum raw mode buffer size.

sv503_sessusers

Specifies the maximum number of users that can be logged on to a server using a single virtual circuit.

sv503_sessconns

Specifies the maximum number of tree connections that can be made on the server using a single virtual circuit.

sv503_maxpagedmemoryusage

Specifies the maximum size of pageable memory that the server can have allocated at any time. Adjust this member if you want to administer memory quota control.

sv503_maxnonpagedmemoryusage

Specifies the maximum size of nonpaged memory that the server can have allocated at any time. Adjust this member if you want to administer memory quota control.

sv503_enableforcedlogoff

Specifies whether the server should force a client to disconnect, even if the client has open files, once the client's logon time has expired.

sv503_timesource

Specifies whether the server is a reliable time source.

sv503_acceptdownlevelapis

Specifies whether the server will accept function calls from previous generation LAN Manager clients.

sv503_lmannounce

Specifies the LAN Manager server announcement interval.

sv503_domain

Specifies the name of the server's domain.

sv503_maxkeepsearch

Specifies the length of time the server will retain information about directory searches that have not ended.

sv503_scavtimeout

Specifies the time that the scavenger remains idle before waking up to service requests. A smaller value for this member improves the response of the server to various events but costs CPU cycles.

sv503_minrcvqueue

Specifies the minimum number of free receive work items needed by the server before it begins allocating more. A larger value for this member helps ensure that there will always be work items available, but a value that is too large is simply inefficient.

sv503_minfreeworkitems

Specifies the minimum number of available receive work items that are needed for the server to begin processing a server message block. A larger value for this member ensures that work items are available more frequently for nonblocking requests, but it also increases the likelihood that blocking requests will be rejected.

sv503_xactmemsize

Specifies the size of the shared memory region used to process server functions.

sv503_threadpriority

Specifies the priority of all server threads in relation to the base priority of the process. Higher priority can give better server performance at the cost of local responsiveness. Lower priority balances server needs with the needs of other processes on the system.

sv503_maxmpxct

Specifies the maximum number of simultaneous requests any one client can send to the server. For example, 10 means you can have 10 unanswered requests at the server. When any single client has 10 requests queued within the server, the client must wait for a server response before sending another request.

sv503_oplockbreakwait

Specifies the time to wait before timing out an opportunistic lock break request.

sv503_oplockbreakresponsewait

Specifies the time to wait before timing out an opportunistic lock break request.

sv503_enableoplocks

Specifies whether the server allows clients to use opportunistic locks on files. Opportunistic locks are a significant performance enhancement, but have the potential to cause lost cached data on some networks, particularly wide-area networks.

sv503_enablefcbopens

Specifies whether several MS-DOS File Control Blocks (FCBs) are placed in a single location accessible by the server. This saves resources on the server.

sv503_enableraw

Specifies whether the server processes raw Server Message Blocks (SMBs). If enabled, this allows more data to transfer per transaction and also improves performance. However, it is possible that processing raw SMBs can impede performance on certain networks. The server maintains the value of this member.

sv503_enablesharednetdrives

Specifies whether the server allows redirected server drives to be shared.

sv503_minfreeconnections

Specifies the minimum number of connection structures the server sets aside to handle bursts of requests by clients to connect to the server.

sv503_maxfreeconnections

Specifies the maximum number of connection structures the server sets aside to handle bursts of requests by clients to connect to the server.

See Also

NetServerGetInfo