Функция DavGetHTTPFromUNCPath (davclnt.h)

Статья
03/05/2024

Преобразует указанный UNC-путь в эквивалентный путь HTTP.

Синтаксис

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

Параметры

[in] UncPath

Указатель на строку Юникода, завершающуюся значением NULL, которая содержит UNC-путь. Этот путь должен иметь следующий формат:

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

where

server — это имя сервера.
@SSL является необязательным и указывает на запрос ssl-подключения.
port — это необязательный номер порта. Стандартные порты : 80 для http и 443 для https (SSL).
Путь является необязательным и указывает путь к удаленному файлу или каталогу на сервере.

[out] Url

Указатель на буфер, выделенный вызывающим объектом, который получает путь HTTP в виде строки Юникода, заканчивающейся null.

[in, out] lpSize

Указатель на переменную, которая во входных данных указывает максимальный размер буфера, на который указывает параметр HttpPath (в символах Юникода). Если функция выполнена успешно, на выходе переменная получает количество символов, скопированных в буфер. Если функция завершается сбоем с ERROR_INSUFFICIENT_BUFFER, на выходе переменная получает количество символов, необходимых для хранения пути HTTP, включая префикс "http://" или "https://" и завершающий символ NULL .

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет ERROR_SUCCESS.

Если функция завершается сбоем, возвращаемое значение представляет собой системный код ошибки, например следующее значение.

Код возврата	Описание
ERROR_INSUFFICIENT_BUFFER	Буфер, на который указывает параметр HttpPath , недостаточно велик для хранения пути HTTP.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	davclnt.h
Библиотека	Netapi32.lib
DLL	Netapi32.dll

Share via