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。
如果函数失败,则返回值是 系统错误代码,例如以下值。
返回代码 | 说明 |
---|---|
|
HttpPath 参数指向的缓冲区不够大,无法存储 HTTP 路径。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | davclnt.h |
Library | Netapi32.lib |
DLL | Netapi32.dll |