REMOTE_NAME_INFO

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

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.

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 the following example.

\\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 would be set to \\servername\sharename\ and the lpRemainingPath member would be set to path\file.

Requirements