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
);
參數
名稱 [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 |