WNetGetConnection (mpr)
Last changed: -71.41.104.4

.
Summary
TODO - a short description

C# Signature:

[DllImport("mpr.dll", CharSet=CharSet.Auto, SetLastError=true)]

public static extern int WNetGetConnection([MarshalAs(UnmanagedType.LPTStr)] string localName, [MarshalAs(UnmanagedType.LPTStr)] StringBuilder remoteName, ref int length);

VB Signature:

<DllImport("mpr.dll")> _

Shared Function WNetGetConnection(<MarshalAs(UnmanagedType.LPTStr)> ByVal localName As String, ByVal remoteName As StringBuilder, ByRef length As Integer) As Integer

End Function

User-Defined Types:

None.

Notes:

localName is the local name for the network resource (drive or printer)

remoteName is a string builder used to return the network name for the resource

length is the current capacity of the StringBuilder

If the call fails because the StringBuilder is not large enough, the call will return a value of 234, and the Length parameter will contain the required size.

Tips & Tricks:

Please add some!

Sample Code:

// This sample code assumes you currently have a drive mapped to p:

// Find out what remote device a local mapping is to

int rc=0;

// Size for the buffer we will use

int bsize=200;

// Create a new stringbuilder, pre-sized as above

StringBuilder rname = new StringBuilder(bsize);

// Call the function

rc = WNetGetConnection("p:", rname, ref bsize);

Sample Code for Visal Basic 2005 Express Edition:

(Without any Error-Handling)

    Declare Function WNetGetConnection Lib "mpr.dll" Alias "WNetGetConnectionA" (ByVal localName As String, _
    ByVal remoteName As System.Text.StringBuilder, ByRef length As Integer) As Integer

    Private Function strToUnc(ByVal path As String)
        Dim length As Integer = 255
        Dim UNC As New System.Text.StringBuilder(length)
        WNetGetConnection(Microsoft.VisualBasic.Left(path, 2), UNC, length)
        Return UNC.ToString
    End Function

    'to get the UNC-Path of a network-drive use something like:
    Private Sub Test()
        Dim dr As String = "J:\"
        MsgBox("The UNC-Path of drive " & dr & " is: " & strToUnc(dr))
    End Sub

Alternative Managed API:

Do you know one? Please contribute it!

Documentation