Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
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_INFOdata 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_INFOstructure's lpConnectionNamemember to the WNetAddConnection2function as the lpRemoteNamemember of the NETRESOURCEstructure 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 lpRemainingPathmember 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 lpConnectionNamemember would be set to \\servername\sharename\ and the lpRemainingPathmember would be set to path\file.

Requirements

Header winnetwk.h
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later