DavGetHTTPFromUNCPath 函数 (davclnt.h)

  • 项目

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

语法

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

参数

[in] UncPath

指向包含 UNC 路径的 以 null 结尾的 Unicode 字符串的指针。 此路径必须采用以下格式：

\\server[@SSL][@port][\path]

where

  • server 是服务器名称。
  • @SSL是可选的，表示 SSL 连接请求。
  • port 是可选的端口号。 对于 http，标准端口为 80，https (SSL) 为 443。
  • path 是可选的，指定服务器上的远程文件或目录的路径。

[out] Url

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

[in, out] lpSize

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

返回值

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

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

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

要求

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