DavGetUNCFromHTTPPath 函数 (davclnt.h)

  • 项目

将指定的 HTTP 路径转换为等效的 UNC 路径。

语法

DWORD DavGetUNCFromHTTPPath(
  [in]      LPCWSTR Url,
  [out]     LPWSTR  UncPath,
  [in, out] LPDWORD lpSize
);

参数

[in] Url

指向包含 HTTP 路径的 以 null 结尾的 Unicode 字符串的指针。 此字符串可以使用以下任何格式，其中 服务器 是服务器名称， 路径 是服务器上的远程文件或目录的路径：

  • http:// 服务器/路径
  • http:// server
  • \\http:// server/路径
  • \\http:// server
  • https:// 服务器/路径
  • https:// server
  • \\https:// server/路径
  • \\https:// server
  • \\server\path
  • \\server

[out] UncPath

指向调用方分配的缓冲区的指针，该缓冲区以 NULL 结尾的 Unicode 字符串的形式接收 UNC 路径。

[in, out] lpSize

指向变量的指针，输入时指定 UncPath 参数指向的缓冲区的最大大小（以 Unicode 字符为单位）。 如果函数成功，则输出时变量将接收复制到缓冲区中的字符数，包括终止 NULL 字符。 如果函数因ERROR_INSUFFICIENT_BUFFER而失败，则输出时变量会收到存储 UNC 路径所需的字符数，包括终止 NULL 字符。

返回值

如果函数成功，则返回值为 ERROR_SUCCESS。

如果函数失败，则返回值是 系统错误代码，例如以下值。

返回代码 说明
ERROR_INSUFFICIENT_BUFFER
 UncPath 参数指向的缓冲区不够大，无法存储 UNC 路径。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 davclnt.h
Library Netapi32.lib
DLL Netapi32.dll