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.