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