MSFT_FileShare 類別
建立 Windows 作業系統檔案共用概念的模型。
下列語法是簡化自 MOF 程式碼，且包含所有繼承的屬性。
語法
class MSFT_FileShare : MSFT_StorageObject
{
String Name;
String Description;
String VolumeRelativePath;
Boolean ContinuouslyAvailable;
Boolean EncryptData;
UInt16 FileSharingProtocol;
UInt16 ShareState;
UInt16 HealthStatus;
UInt16 OperationalStatus[];
};
成員
MSFT_FileShare 類別具有下列類型的成員：
方法
MSFT_FileShare 類別具有這些方法。
| 方法 | Description |
|---|---|
| BlockAccess | 拒絕對檔案共用的指定使用者存取。 |
| DeleteObject | 刪除檔案共用。 |
| 診斷 | 對檔案共用執行診斷，並傳回任何可採取動作的結果。 |
| GetAccessControlEntries | 取得指定帳戶的訪問控制專案。 |
| GrantAccess | 將指定存取權授與指定的用戶帳戶給檔案共用。 |
| RevokeAccess | 撤銷指定使用者的檔案共享存取權。 |
| SetAttributes | 允許使用者更新或設定檔案共用上的各種屬性。 |
| SetDescription | 允許使用者設定檔案共用的描述欄位。 |
| UnblockAccess | 從檔案共享的拒絕存取清單中移除指定的使用者。 |
屬性
MSFT_FileShare類別具有這些屬性。
ContinuouslyAvailable
數據類型： 布爾值
存取類型：唯讀
如果 為 TRUE，則共用會持續可用。
描述
數據類型： 字串
存取類型：唯讀
用戶可設定的檔案共用描述。 此欄位可用來儲存額外的自由格式資訊，例如附註或預定使用方式的詳細數據。 某些共用不允許設定描述，而且會支持預設描述，或不支援任何描述。
EncryptData
數據類型： 布爾值
存取類型：唯讀
如果 為TRUE，則共享數據會在傳輸期間加密。
FileSharingProtocol
數據類型： UInt16
存取類型：唯讀
共用所使用的檔案共享通訊協定。
NFS (2)
CIFS (SMB) (3)
HealthStatus
數據類型： UInt16
存取類型：唯讀
檔案共用的目前健全狀態。
狀況良好的 (0)
警告 (1)
狀況不良 (2)
未知 (5)
名稱
數據類型： 字串
存取類型：唯讀
限定符： 必要
範圍設定為擁有文件伺服器) 、用來識別及存取檔案共用之人類可讀取字串的半唯一 (。
OperationalStatus
數據類型： UInt16 陣列
存取類型：唯讀
值的陣列，表示檔案共用的目前作業狀態。 不同於 HealthStatus，此字段指出與此共用相關的硬體、軟體和基礎結構問題的狀態，而且可以包含多個值。
未知 (0)
其他 (1)
確定 (2)
降級 (3)
壓力 (4)
預測性失敗 (5)
錯誤 (6)
無法復原的錯誤 (7)
開始 (8)
停止 (9)
已停止 (10)
在 Service (11)
沒有聯繫人 (12)
遺失通訊 (13)
中止 (14)
休眠 (15)
錯誤 (16) 支持實體
已完成 (17)
電源模式 (18 )
重新放置 (19 )
Microsoft 保留 (。。)
唯讀 (0xD000)
不完整 的 (0xD001)
Microsoft Reserved (0xD001..)
ShareState
數據類型： UInt16
存取類型：唯讀
檔案共用的目前狀態。
擱 置 (0)
在線 (1)
離線 (2)
VolumeRelativePath
數據類型： 字串
存取類型：唯讀
所共享目錄的磁碟區相對路徑。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 10 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2016 [僅限傳統型應用程式] |
| 命名空間 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |