REMOTE_NAME_INFO

This structure contains path and name data about a network resource. The structure contains a member that points to a Universal Naming Convention (UNC) name string for the resource, and two members that point to additional network connection data strings.

At a Glance

Syntax

typedef struct _REMOTE_NAME_INFO {
LPTSTR lpUniversalName;
LPTSTR lpConnectionName;
LPTSTR lpRemainingPath;
} REMOTE_NAME_INFO;

Members

lpUniversalName

Long pointer to a zero-terminated UNC name string.

lpConnectionName

Long pointer to a zero-terminated string that is the name of a network connection.

lpRemainingPath

Long pointer to a zero-terminated UNC name string.

Remarks

The REMOTE_NAME_INFO data structure contains a pointer to a Universal Naming Convention (UNC) name string. UNC names look like this:

\\servername\sharename\path\file 
 

You can pass the REMOTE_NAME_INFO structure’s lpConnectionName member to the WNetAddConnection2 function as the lpRemoteName member of the NETRESOURCE structure pointed to by lpNetResource. This lets you create a local connection to a network resource. You can then append the string pointed to by the lpRemainingPath member to the local device string “\network\localname”, and pass the resulting string to Win32 functions that use a file-based path.

For example in the case of the UNC path \\servername\sharename\path\file, the lpConnectionName member woud be set to \\servername\sharename\ and the lpRemainingPath member would be set to path\file.