通过

NPGetUniversalName 函数 (npapi.h)

  • 项目

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

语法

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

参数

[in] lpLocalPath

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

[in] dwInfoLevel

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

值 含义
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。 否则，它应返回错误代码，可能是以下代码之一。

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

要求

要求 值
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 npapi.h