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;
    LPWSTR    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 operating system 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.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in lmserver.h.

See Also

Networking (Net) Overview, Net Structures, NetServerGetInfo