Share via

REMOTE_NAME_INFO

  • Article

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.

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

OS Versions: Windows CE 2.0 and later.
Header: Winnetwk.h.

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.