/* Copyright (C) 2008-2016 Peter Palotas, Jeffrey Jangli, Alexandr Normuradov * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell * copies of the Software, and to permit persons to whom the Software is * furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in * all copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN * THE SOFTWARE. */ using Alphaleonis.Win32.Filesystem; using System; using System.Globalization; namespace Alphaleonis.Win32.Network { /// Contains information about Server Message Block (SMB) shares. This class cannot be inherited. [SerializableAttribute] public sealed class ShareInfo { #region Constructor #region ShareInfo /// Creates a instance. /// A host to retrieve shares from. /// One of the options. /// A or instance. internal ShareInfo(string host, ShareInfoLevel shareLevel, object shareInfo) { switch (shareLevel) { case ShareInfoLevel.Info1005: NativeMethods.SHARE_INFO_1005 s1005 = (NativeMethods.SHARE_INFO_1005) shareInfo; ServerName = host ?? Environment.MachineName; ResourceType = s1005.shi1005_flags; break; case ShareInfoLevel.Info503: NativeMethods.SHARE_INFO_503 s503 = (NativeMethods.SHARE_INFO_503) shareInfo; CurrentUses = s503.shi503_current_uses; MaxUses = s503.shi503_max_uses; NetName = s503.shi503_netname; Password = s503.shi503_passwd; Path = Utils.IsNullOrWhiteSpace(s503.shi503_path) ? null : s503.shi503_path; Permissions = s503.shi503_permissions; Remark = s503.shi503_remark; ServerName = s503.shi503_servername == "*" ? host ?? Environment.MachineName : s503.shi503_servername; ShareType = s503.shi503_type; SecurityDescriptor = s503.shi503_security_descriptor; break; case ShareInfoLevel.Info2: NativeMethods.SHARE_INFO_2 s2 = (NativeMethods.SHARE_INFO_2)shareInfo; CurrentUses = s2.shi2_current_uses; MaxUses = s2.shi2_max_uses; NetName = s2.shi2_netname; Password = s2.shi2_passwd; Path = Utils.IsNullOrWhiteSpace(s2.shi2_path) ? null : s2.shi2_path; Permissions = s2.shi2_permissions; Remark = s2.shi2_remark; ServerName = host ?? Environment.MachineName; ShareType = s2.shi2_type; break; case ShareInfoLevel.Info1: NativeMethods.SHARE_INFO_1 s1 = (NativeMethods.SHARE_INFO_1)shareInfo; CurrentUses = 0; MaxUses = 0; NetName = s1.shi1_netname; Password = null; Path = null; Permissions = AccessPermissions.None; Remark = s1.shi1_remark; ServerName = host ?? Environment.MachineName; ShareType = s1.shi1_type; break; } NetFullPath = string.Format(CultureInfo.CurrentCulture, "{0}{1}{2}{3}", Filesystem.Path.UncPrefix, ServerName, Filesystem.Path.DirectorySeparatorChar, NetName); ShareLevel = shareLevel; } #endregion // ShareInfo #endregion // Constructor #region Methods #region ToString /// Returns the full path to the share. /// A string that represents this instance. public override string ToString() { return NetFullPath; } #endregion // ToString #endregion // Methods #region Properties #region CurrentUses /// The number of current connections to the resource. public long CurrentUses { get; private set; } #endregion // CurrentUses #region DirectoryInfo private DirectoryInfo _directoryInfo; /// The instance associated with this share. public DirectoryInfo DirectoryInfo { get { // Do not use ?? expression here. if (_directoryInfo == null) _directoryInfo = new DirectoryInfo(null, NetFullPath, PathFormat.FullPath); return _directoryInfo; } } #endregion // DirectoryInfo #region NetFullPath /// Returns the full UNC path to the share. public string NetFullPath { get; internal set; } #endregion // NetFullPath #region MaxUses /// The maximum number of concurrent connections that the shared resource can accommodate. /// The number of connections is unlimited if the value specified in this member is –1. public long MaxUses { get; private set; } #endregion // MaxUses #region NetName /// The name of a shared resource. public string NetName { get; private set; } #endregion // NetName #region Password /// The share's password (when the server is running with share-level security). public string Password { get; private set; } #endregion // Password #region Path /// The local path for the shared resource. /// For disks, this member is the path being shared. For print queues, this member is the name of the print queue being shared. public string Path { get; private set; } #endregion // Path #region Permissions /// The shared resource's permissions for servers running with share-level security. /// Note that Windows does not support share-level security. This member is ignored on a server running user-level security. public AccessPermissions Permissions { get; private set; } #endregion // Permissions #region Remark /// An optional comment about the shared resource. public string Remark { get; private set; } #endregion // Remark #region SecurityDescriptor /// Specifies the SECURITY_DESCRIPTOR associated with this share. public IntPtr SecurityDescriptor { get; private set; } #endregion // SecurityDescriptor #region ServerName /// A pointer to a string that specifies the DNS or NetBIOS name of the remote server on which the shared resource resides. /// A value of "*" indicates no configured server name. public string ServerName { get; private set; } #endregion // ServerName #region ShareType /// The type of share. public ShareType ShareType { get; private set; } #endregion // ShareType #region ResourceType private ShareResourceTypes _shareResourceType; /// The type of share resource. public ShareResourceTypes ResourceType { get { if (_shareResourceType == ShareResourceTypes.None && !Utils.IsNullOrWhiteSpace(NetName)) _shareResourceType = (Host.GetShareInfoCore(ShareInfoLevel.Info1005, ServerName, NetName, true)).ResourceType; return _shareResourceType; } private set { _shareResourceType = value; } } #endregion // ResourceType #region ShareLevel /// The structure level for the ShareInfo instance. public ShareInfoLevel ShareLevel { get; private set; } #endregion // ShareLevel #endregion // Properties } }