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.

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 structures 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.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 2.0 and later Winnetwk.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.