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