Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

CreateShare method of the MSFT_SmbShare class

Creates a new share and allows the creator to specify initial access rights that determine who can and can’t access the newly created share.

Syntax


uint32 CreateShare(
  [in]   string Name,
  [in]   string ScopeName,
  [in]   string Path,
  [in]   string Description,
  [in]   uint32 ConcurrentUserLimit,
  [in]   uint32 FolderEnumerationMode,
  [in]   uint32 CachingMode,
  [in]   boolean Temporary,
  [in]   boolean ContinuouslyAvailable,
  [in]   uint32 CATimeout,
  boolean EncryptData,
  [in]   string FullAccess[],
  [in]   string ChangeAccess[],
  [in]   string ReadAccess[],
  [in]   string NoAccess[],
  [in]   string SecurityDescriptor,
  [out]  MSFT_SmbShare CreatedShare
);

Parameters

Name [in]

Name of the share.

ScopeName [in]

Name of the endpoint to which the share is scoped.

Path [in]

Absolute path to the file system directory that is shared. Null if the share is not a file share.

Description [in]

Optional description of the share.

ConcurrentUserLimit [in]

Maximum number of users that may concurrently access the share. If this property is zero, there is no limit.

FolderEnumerationMode [in]

The enumeration mode that is enabled for the share.

ValueMeaning
AccessBased
0

Access-based

Unrestricted
1

Unrestricted

 

CachingMode [in]

The caching policy for the share.

None (0)
Manual (1)
Documents (2)
Programs (3)
BranchCache (4)
Unknown (5)
Temporary [in]

Indicates whether this is a temporary share.

ContinuouslyAvailable [in]

Indicates whether the share supports continuous availability.

CATimeout [in]

In case of a failover, the number of seconds the client will wait before failing the operation.

EncryptData

Indicates whether the data on the share should be encrypted.

FullAccess [in]

An array of strings containing the account names of users to be granted full access to the share.

ChangeAccess [in]

An array of strings containing the account names of users to be granted change access to the share.

ReadAccess [in]

An array of strings containing the account names of users to be granted read-only access to the share.

NoAccess [in]

An array of strings containing the account names of users to be granted no access to the share.

SecurityDescriptor [in]

The name of the security descriptor of the share.

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

CreatedShare [out]

An instance of the MSFT_SmbShare class that represents the share.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Namespace

\ROOT\Microsoft\Windows\Smb

MOF

SmbWmiV2.mof

DLL

SmbWmiV2.dll

See also

MSFT_SmbShare
NetShareAdd

 

 

Show:
© 2014 Microsoft