REMOTE_NAME_INFO structure

The REMOTE_NAME_INFO structure contains path and name information for 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 information strings.

Syntax


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

Members

lpUniversalName

Pointer to the null-terminated UNC name string that identifies a network resource.

lpConnectionName

Pointer to a null-terminated string that is the name of a network connection. For more information, see the following Remarks section.

lpRemainingPath

Pointer to a null-terminated name string. For more information, see the following Remarks section.

Remarks

The REMOTE_NAME_INFO structure contains a pointer to a Universal Naming Convention (UNC) name string. A UNC path identifies a network resource in an unambiguous, computer-independent manner. You can pass the path to processes on other computers, allowing those processes to obtain access to the network resource.

UNC names look like this:

\\servername\sharename\path\file

In addition, if you pass the value of the lpConnectionName member to the WNetAddConnection2 function, it enables you to connect a local device to a network resource. You can do this by passing the value of lpConnectionName in the lpRemoteName member of the NETRESOURCE structure pointed to by the function's lpNetResource parameter.

If you append the string pointed to by the lpRemainingPath member of REMOTE_NAME_INFO to the local device string, you can pass the resulting string to functions that require a drive-based path.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winnetwk.h

Unicode and ANSI names

REMOTE_NAME_INFOW (Unicode) and REMOTE_NAME_INFOA (ANSI)

See also

Windows Networking (WNet) Overview
Windows Networking Structures
WNetAddConnection2
NETRESOURCE
UNIVERSAL_NAME_INFO

 

 

Community Additions

ADD
Show:
© 2014 Microsoft