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

Статья
08/23/2023

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

Синтаксис

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

Параметры

[in] Url

Указатель на строку Юникода, завершающуюся значением NULL, которая содержит HTTP-путь. Эта строка может быть в любом из следующих форматов, где server — это имя сервера, а путь — путь к удаленному файлу или каталогу на сервере:

Путь http://сервера/
http:// сервер
\\http://путь ксерверу/
\\http:// server
Путь https://сервера/
https:// сервер
\\https://путь ксерверу/
\\https:// server
\\server\path
\\server

[out] UncPath

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

[in, out] lpSize

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

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

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

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

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

Требования


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

Share via