You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

NativeMethods.DistributedFileSystem.cs 4.8 KiB

8 jaren geleden
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778
  1. /* Copyright (C) 2008-2016 Peter Palotas, Jeffrey Jangli, Alexandr Normuradov
  2. *
  3. * Permission is hereby granted, free of charge, to any person obtaining a copy
  4. * of this software and associated documentation files (the "Software"), to deal
  5. * in the Software without restriction, including without limitation the rights
  6. * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  7. * copies of the Software, and to permit persons to whom the Software is
  8. * furnished to do so, subject to the following conditions:
  9. *
  10. * The above copyright notice and this permission notice shall be included in
  11. * all copies or substantial portions of the Software.
  12. *
  13. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  14. * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  15. * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  16. * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  17. * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  18. * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  19. * THE SOFTWARE.
  20. */
  21. using System;
  22. using System.Diagnostics.CodeAnalysis;
  23. using System.Runtime.InteropServices;
  24. using System.Security;
  25. namespace Alphaleonis.Win32.Network
  26. {
  27. internal static partial class NativeMethods
  28. {
  29. /// <summary>Enumerates the Distributed File System (DFS) namespaces hosted on a server or DFS links of a namespace hosted by a server.</summary>
  30. /// <returns>
  31. /// If the function succeeds, the return value is NERR_Success.
  32. /// If the function fails, the return value is a system error code.
  33. /// </returns>
  34. /// <remarks>
  35. /// <para>No special group membership is required for using the NetDfsEnum function.</para>
  36. /// <para>Minimum supported client: Windows Vista</para>
  37. /// <para>Minimum supported server: Windows Server 2003</para>
  38. /// </remarks>
  39. [SuppressMessage("Microsoft.Security", "CA5122:PInvokesShouldNotBeSafeCriticalFxCopRule")]
  40. [DllImport("netapi32.dll", SetLastError = true, CharSet = CharSet.Unicode), SuppressUnmanagedCodeSecurity]
  41. [return: MarshalAs(UnmanagedType.U4)]
  42. internal static extern uint NetDfsEnum([MarshalAs(UnmanagedType.LPWStr)] string dfsName, [MarshalAs(UnmanagedType.U4)] uint level, [MarshalAs(UnmanagedType.U4)] int prefMaxLen, out SafeGlobalMemoryBufferHandle buffer, [MarshalAs(UnmanagedType.U4)] out uint entriesRead, [MarshalAs(UnmanagedType.U4)] out uint resumeHandle);
  43. /// <summary>Retrieves information about a Distributed File System (DFS) root or link from the cache maintained by the DFS client.</summary>
  44. /// <returns>
  45. /// If the function succeeds, the return value is NERR_Success.
  46. /// If the function fails, the return value is a system error code.
  47. /// </returns>
  48. /// <remarks>
  49. /// <para>No special group membership is required for using the NetDfsGetClientInfo function.</para>
  50. /// <para>Minimum supported client: Windows Vista</para>
  51. /// <para>Minimum supported server: Windows Server 2003</para>
  52. /// </remarks>
  53. [SuppressMessage("Microsoft.Security", "CA5122:PInvokesShouldNotBeSafeCriticalFxCopRule")]
  54. [DllImport("netapi32.dll", SetLastError = true, CharSet = CharSet.Unicode), SuppressUnmanagedCodeSecurity]
  55. [return: MarshalAs(UnmanagedType.U4)]
  56. internal static extern uint NetDfsGetClientInfo([MarshalAs(UnmanagedType.LPWStr)] string dfsEntryPath, [MarshalAs(UnmanagedType.LPWStr)] string serverName, [MarshalAs(UnmanagedType.LPWStr)] string shareName, [MarshalAs(UnmanagedType.U4)] uint level, out SafeGlobalMemoryBufferHandle buffer);
  57. /// <summary>Retrieves information about a specified Distributed File System (DFS) root or link in a DFS namespace.</summary>
  58. /// <returns>
  59. /// If the function succeeds, the return value is NERR_Success.
  60. /// If the function fails, the return value is a system error code.
  61. /// </returns>
  62. /// <remarks>
  63. /// <para>No special group membership is required for using the NetDfsGetInfo function.</para>
  64. /// <para>Minimum supported client: Windows Vista</para>
  65. /// <para>Minimum supported server: Windows Server 2003</para>
  66. /// </remarks>
  67. [SuppressMessage("Microsoft.Security", "CA5122:PInvokesShouldNotBeSafeCriticalFxCopRule")]
  68. [DllImport("netapi32.dll", SetLastError = true, CharSet = CharSet.Unicode), SuppressUnmanagedCodeSecurity]
  69. [return: MarshalAs(UnmanagedType.U4)]
  70. internal static extern uint NetDfsGetInfo([MarshalAs(UnmanagedType.LPWStr)] string dfsEntryPath, [MarshalAs(UnmanagedType.LPWStr)] string serverName, [MarshalAs(UnmanagedType.LPWStr)] string shareName, [MarshalAs(UnmanagedType.U4)] uint level, out SafeGlobalMemoryBufferHandle buffer);
  71. }
  72. }