Поделиться через

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

  • Статья

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

Синтаксис

DWORD DavGetExtendedError(
  [in]      HANDLE hFile,
  [out]     DWORD  *ExtError,
  [out]     LPWSTR ExtErrorString,
  [in, out] DWORD  *cChSize
);

Параметры

[in] hFile

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

[out] ExtError

Указатель на переменную, которая получает расширенный код ошибки.

[out] ExtErrorString

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

[in, out] cChSize

Указатель на переменную, которая на входных данных указывает размер буфера, на который указывает параметр ExtErrorString в символах Юникода. Это значение должно содержать не менее 1024 символов.

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

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

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

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

Код возврата Описание
ERROR_INVALID_PARAMETER
 Одно или несколько значений параметров были недопустимыми.
ERROR_INSUFFICIENT_BUFFER
 Значение, на которое указывает параметр cChSize , меньше 1024.

Комментарии

Если вы вызываете эту функцию для дескриптора файла, предыдущая операция ввода-вывода которого прошла успешно, она возвращает ERROR_INVALID_PARAMETER.

Требования

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

См. также раздел

CreateFile

OpenFile

WriteFile