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