MSFT_FileServer 类的 CreateFileShare 方法

在文件服务器上创建文件共享。

语法

UInt32 CreateFileShare(
  [in]  String              Name,
  [in]  String              Description,
  [in]  String              SourceVolume,
  [in]  String              VolumeRelativePath,
  [in]  Boolean             ContinuouslyAvailable,
  [in]  Boolean             EncryptData,
  [in]  UInt16              FileSharingProtocol,
  [out] String              CreatedFileShare,
  [out] MSFT_StorageJob REF CreatedStorageJob,
  [out] String              ExtendedStatus
);

参数

Name [in]

一个半唯一 (范围限定为拥有的文件服务器,) 用于标识文件共享的可读字符串。

说明 [in]

文件共享的用户可设置说明。 此字段可用于存储额外的自由格式信息,例如备注或有关预期用法的详细信息。

SourceVolume [in]

一个字符串,其中包含一个嵌入 MSFT_Volume 对象,该对象指定要在其中创建共享的卷。

VolumeRelativePath [in]

要共享的现有目录的卷相对路径。 如果未提供此参数,则将创建一个空共享。

ContinuouslyAvailable [in]

如果 为 TRUE,则共享将持续可用。

EncryptData [in]

如果 为 TRUE,则共享数据将在传输过程中加密。

FileSharingProtocol [in]

如果服务器支持多个协议,则共享要使用的文件共享协议。

NFS (2)

CIFS (SMB) (3)

CreatedFileShare [out]

此参数接收一个字符串,其中包含表示新文件共享的嵌入 MSFT_FileShare 对象。

CreatedStorageJob [out]

返回对用于跟踪长时间运行的操作的存储作业对象的引用。

ExtendedStatus [out]

包含嵌入 MSFT_StorageExtendedStatus 对象的字符串。

此参数允许存储提供程序返回特定于实现的扩展 () 错误信息。

返回值

成功 (0)

不支持 (1)

未指定的错误 (2)

超时 (3)

失败 (4)

参数 (5) 无效

方法参数已选中 - 作业已启动 (4096)

不支持的大小 (4097)

拒绝访问 (40001)

没有足够的资源来完成操作。 (40002)

请求的访问路径已在使用中。 (42002)

访问路径无效。 (42007)

必须为此文件共享指定名称。 (58000)

必须为此文件共享指定共享协议。 (58001)

必须为此文件共享指定卷。 (58002)

要求

要求
最低受支持的客户端 Windows 10 [仅限桌面应用]
最低受支持的服务器 Windows Server 2016 [仅限桌面应用]
命名空间 Root\Microsoft\Windows\Storage
MOF Storagewmi.mof

另请参阅

MSFT_FileServer