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

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

  • Статья

Клиент 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.

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

Комментарии

Функция обратного вызова DavAuthCallback должна быть зарегистрирована путем вызова функции DavRegisterAuthCallback .

Чтобы отменить регистрацию этой функции обратного вызова, используйте функцию DavUnregisterAuthCallback .

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

Требования

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

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

CredUIPromptForCredentials

CredUIPromptForWindowsCredentials

DAV_CALLBACK_AUTH_BLOB

DAV_CALLBACK_AUTH_UNP

DavFreeCredCallback