Export (0) Print
Expand All
4 out of 8 rated this helpful - Rate this topic

MSFT_SmbClientConfiguration class

Represents the configuration settings for an SMB client.

The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties.

Syntax

class MSFT_SmbClientConfiguration
{
  uint32  ConnectionCountPerRssNetworkInterface;
  uint32  DirectoryCacheEntriesMax;
  uint32  DirectoryCacheEntrySizeMax;
  uint32  DirectoryCacheLifetime;
  boolean EnableBandwidthThrottling;
  boolean EnableByteRangeLockingOnReadOnlyFiles;
  boolean EnableLargeMtu;
  boolean EnableMultiChannel;
  uint32  DormantFileLimit;
  boolean EnableSecuritySignature;
  uint32  ExtendedSessionTimeout;
  uint32  FileInfoCacheEntriesMax;
  uint32  FileInfoCacheLifetime;
  uint32  FileNotFoundCacheEntriesMax;
  uint32  FileNotFoundCacheLifetime;
  uint32  KeepConn;
  uint32  MaxCmds;
  uint32  MaximumConnectionCountPerServer;
  boolean OplocksDisabled;
  boolean RequireSecuritySignature;
  uint32  SessionTimeout;
  boolean UseOpportunisticLocking;
  uint32  WindowSizeThreshold;
  boolean EnableLoadBalanceScaleOut;
};

Members

The MSFT_SmbClientConfiguration class has these types of members:

Methods

The MSFT_SmbClientConfiguration class has these methods.

MethodDescription
GetConfiguration

Retrieves SMB client configuration settings.

SetConfiguration

Sets one or more SMB client configuration settings.

 

Properties

The MSFT_SmbClientConfiguration class has these properties.

ConnectionCountPerRssNetworkInterface
Data type: uint32
Access type: Read/write

The number of TCP connections per RSS network interface.

DirectoryCacheEntriesMax
Data type: uint32
Access type: Read/write

The maximum number of entries that can be stored in the directory cache.

DirectoryCacheEntrySizeMax
Data type: uint32
Access type: Read/write

The maximum size, in bytes, of an entry in the directory cache.

DirectoryCacheLifetime
Data type: uint32
Access type: Read/write

The maximum lifetime, in seconds, of the directory cache.

DormantFileLimit
Data type: uint32
Access type: Read/write

The maximum number of file handles the SMB network redirector can continue to keep open after the application has closed the corresponding handle.

EnableBandwidthThrottling
Data type: boolean
Access type: Read/write

Controls whether bandwidth throttling is enabled.

EnableByteRangeLockingOnReadOnlyFiles
Data type: boolean
Access type: Read/write

Controls whether byte-range locking is enabled on read-only files.

EnableLargeMtu
Data type: boolean
Access type: Read/write

Controls whether the Large MTU (maximum transmission unit) feature is enabled.

EnableLoadBalanceScaleOut
Data type: boolean
Access type: Read/write

Specifies whether load balancing is enabled with scale out clusters. true to enable load balancing with scale out clusters; false to disable it.

Windows Server 2012 and Windows 8:  This property is not supported before Windows Server 2012 R2 and Windows 8.1.

EnableMultiChannel
Data type: boolean
Access type: Read/write

Enable the use of multiple physical network interfaces.

EnableSecuritySignature
Data type: boolean
Access type: Read/write

Controls whether security signatures are enabled.

ExtendedSessionTimeout
Data type: uint32
Access type: Read/write

An additional timeout, in seconds, for the SMB client to wait for servers that take more than 45 seconds to respond. (See the SessionTimeout property.) The default value is zero.

FileInfoCacheEntriesMax
Data type: uint32
Access type: Read/write

The maximum number of entries that can be stored in the file information cache.

FileInfoCacheLifetime
Data type: uint32
Access type: Read/write

The maximum lifetime, in seconds, of the file information cache.

FileNotFoundCacheEntriesMax
Data type: uint32
Access type: Read/write

The maximum number of entries that can be stored in the file not found cache.

FileNotFoundCacheLifetime
Data type: uint32
Access type: Read/write

The maximum lifetime, in seconds, of the file not found cache.

KeepConn
Data type: uint32
Access type: Read/write

Specifies the maximum amount of time, in seconds, that an idle connection can remain open. If the idle time for a connection reaches the value of this entry, the connection is closed. The default value is 600.

Note   This is an SMB1-only setting.

MaxCmds
Data type: uint32
Access type: Read/write

Specifies the maximum number of network control blocks that the redirector can reserve. The value of this entry coincides with the number of execution threads that can be outstanding simultaneously.

Note   This is an SMB1-only setting.

MaximumConnectionCountPerServer
Data type: uint32
Access type: Read/write

The maximum number of Multichannel client connections (across multiple interfaces) for a given server. The default value is 8.

OplocksDisabled
Data type: boolean
Access type: Read/write

true if opportunistic locking is disabled. See UseOpportunisticLocking.

RequireSecuritySignature
Data type: boolean
Access type: Read/write

Controls whether security signatures are required.

SessionTimeout
Data type: uint32
Access type: Read/write

The number of seconds that the client waits before disconnecting an inactive session. The default value is 45.

UseOpportunisticLocking
Data type: boolean
Access type: Read/write

Controls whether the opportunistic-locking (oplock) performance enhancement is enabled. If enabled, the redirector requests an opportunistic lock on any file opened in "Deny None" mode. As a result, the server performs automatic read-ahead and write-behind caching on behalf of the redirector.

WindowSizeThreshold
Data type: uint32
Access type: Read/write

The minimum window size before Multichannel will trigger the use of multiple connections. The default value is 1 for Windows Server operating systems and 8 for Windows client operating systems.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Namespace

\ROOT\Microsoft\Windows\Smb

MOF

SmbWmiV2.mof

DLL

SmbWmiV2.dll

 

 

Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.