通过

NPGetUniversalName 函数 （npapi.h）

检索网络资源的通用名称。 NPGetUniversalName 函数可以采用 UNC 格式或较旧的远程名称格式检索此通用名称。

Syntax

DWORD NPGetUniversalName(
  [in]      LPCWSTR lpLocalPath,
  [in]      DWORD   dwInfoLevel,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

参数

[in] lpLocalPath

指向网络资源上对象的本地路径的指针。 这是一个基于驱动器的路径。

[in] dwInfoLevel

调用方感兴趣的信息的详细信息级别。 这可以是以下值之一。

价值 Meaning
UNIVERSAL_NAME_INFO_LEVEL
 检索名称的 UNC 形式，例如：“file：\\server\share”

如果设置了此值， 则 lpBuffer 中返回的数据存储为 UNIVERSAL_NAME_INFO 结构。
REMOTE_NAME_INFO_LEVEL
 检索名称的远程形式，例如：“\\server\share”

如果设置了此值， 则 lpBuffer 中返回的数据存储为 REMOTE_NAME_INFO 结构。

[out] lpBuffer

指向缓冲区的指针，用于接收用户请求的信息。 返回的特定结构取决于 dwInfoLevel 中指定的信息级别。

[in, out] lpBufferSize

指向 lpBuffer 缓冲区的大小（以字节为单位）的指针。 如果调用失败，因为缓冲区不够大，则此位置将用于返回所需的缓冲区大小。

返回值

如果函数成功，它应返回WN_SUCCESS。 否则，它应返回错误代码，这可能是以下代码之一。

返回代码 Description
WN_BAD_LOCALNAME
 传入 lpLocalPath 的值无效。
WN_NOT_CONNECTED
 传递到 lpLocalPath 的值不是重定向设备。
WN_MORE_DATA
 缓冲区太小。
WN_NO_NETWORK
 网络不存在。

要求

Requirement 价值
最低支持的客户端 Windows XP [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows操作系统
Header npapi.h
Library davclnt.lib