Функция обратного вызова PFNDAVAAVAUTHCALLBACK (davclnt.h)

Статья
08/23/2023

Клиент WebDAV вызывает определяемую приложением функцию обратного вызова DavAuthCallback , чтобы заставить у пользователя учетные данные.

Тип PFNDAVAUTHCALLBACK определяет указатель на эту функцию обратного вызова. DavAuthCallback — это заполнитель для имени функции, определяемой приложением.

Синтаксис

PFNDAVAUTHCALLBACK Pfndavauthcallback;

DWORD Pfndavauthcallback(
  [in]      LPWSTR lpwzServerName,
  [in]      LPWSTR lpwzRemoteName,
  [in]      DWORD dwAuthScheme,
  [in]      DWORD dwFlags,
  [in, out] PDAV_CALLBACK_CRED pCallbackCred,
  [in, out] AUTHNEXTSTEP *NextStep,
  [out]     PFNDAVAUTHCALLBACK_FREECRED *pFreeCred
)
{...}

Параметры

[in] lpwzServerName

Указатель на строку Юникода с завершением NULL, содержащую имя целевого сервера.

[in] lpwzRemoteName

Указатель на строку Юникода, завершающуюся null, которая содержит имя сетевого ресурса.

[in] dwAuthScheme

Битовая маска флагов, указывающих используемые схемы проверки подлинности.

Значение	Значение
DAV_AUTHN_SCHEME_BASIC 0x00000001	Необходимо использовать обычную проверку подлинности.
DAV_AUTHN_SCHEME_NTLM 0x00000002	Необходимо использовать проверку подлинности Microsoft NTLM.
DAV_AUTHN_SCHEME_PASSPORT 0x00000004	Необходимо использовать проверку подлинности по паспорту.
DAV_AUTHN_SCHEME_DIGEST 0x00000008	Будет использоваться дайджест-проверка подлинности Майкрософт.
DAV_AUTHN_SCHEME_NEGOTIATE 0x00000010	Мы будем использовать Microsoft Negotiate.
DAV_AUTHN_SCHEME_CERT 0x00010000	Необходимо использовать проверку подлинности на основе сертификата.
DAV_AUTHN_SCHEME_FBA 0x00100000	Необходимо использовать проверку подлинности на основе форм.

[in] dwFlags

Флаги, переданные службой WebDAV в параметре dwFlags при вызове функции NPAddConnection3 .

[in, out] pCallbackCred

Указатель на структуру DAV_CALLBACK_CRED .

[in, out] NextStep

Указатель на значение перечисления AUTHNEXTSTEP , указывающее следующее действие, которое клиент WebDAV должен выполнить после успешного вызова функции обратного вызова DavAuthCallback .

[out] pFreeCred

Указатель на функцию обратного вызова DavFreeCredCallback .

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

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

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

Эта функция обратного вызова должна запрашивать у пользователя учетные данные ( имя пользователя и пароль или большой двоичный объект для проверки подлинности) и сохранять эти сведения в соответствующем элементе структуры DAV_CALLBACK_CRED , на которую указывает параметр pCallbackCred .

Требования


Минимальная версия клиента	Windows Vista с пакетом обновления 2 (SP2) [только классические приложения]
Минимальная версия сервера	Windows Server 2008 с пакетом обновления 2 (SP2) [только классические приложения]
Целевая платформа	Windows
Header	davclnt.h