Fungsi panggilan balik PFNDAVAUTHCALLBACK (davclnt.h)

Artikel
2023-08-23

Klien WebDAV memanggil fungsi panggilan balik DavAuthCallback yang ditentukan aplikasi untuk meminta kredensial kepada pengguna.

Jenis PFNDAVAUTHCALLBACK mendefinisikan penunjuk ke fungsi panggilan balik ini. DavAuthCallback adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi.

Sintaks

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
)
{...}

Parameter

[in] lpwzServerName

Penunjuk ke string Unicode yang dihentikan NULL yang berisi nama server target.

[in] lpwzRemoteName

Penunjuk ke string Unicode yang dihentikan NULL yang berisi nama sumber daya jaringan.

[in] dwAuthScheme

Bitmask bendera yang menentukan skema autentikasi yang akan digunakan.

Nilai	Makna
DAV_AUTHN_SCHEME_BASIC 0x00000001	Autentikasi dasar akan digunakan.
DAV_AUTHN_SCHEME_NTLM 0x00000002	Autentikasi Microsoft NTLM akan digunakan.
DAV_AUTHN_SCHEME_PASSPORT 0x00000004	Autentikasi paspor akan digunakan.
DAV_AUTHN_SCHEME_DIGEST 0x00000008	Autentikasi Microsoft Digest akan digunakan.
DAV_AUTHN_SCHEME_NEGOTIATE 0x00000010	Microsoft Negosiasi akan digunakan.
DAV_AUTHN_SCHEME_CERT 0x00010000	Autentikasi sertifikat akan digunakan.
DAV_AUTHN_SCHEME_FBA 0x00100000	Autentikasi berbasis formulir akan digunakan.

[in] dwFlags

Bendera yang diteruskan layanan WebDAV dalam parameter dwFlags ketika disebut fungsi NPAddConnection3 .

[in, out] pCallbackCred

Penunjuk ke struktur DAV_CALLBACK_CRED .

[in, out] NextStep

Penunjuk ke nilai enumerasi AUTHNEXTSTEP yang menentukan tindakan berikutnya yang harus dilakukan klien WebDAV setelah panggilan berhasil ke fungsi panggilan balik DavAuthCallback .

[out] pFreeCred

Penunjuk ke fungsi panggilan balik DavFreeCredCallback .

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem.

Keterangan

Fungsi panggilan balik DavAuthCallback harus didaftarkan dengan memanggil fungsi DavRegisterAuthCallback .

Untuk membatalkan pendaftaran fungsi panggilan balik ini, gunakan fungsi DavUnregisterAuthCallback .

Fungsi panggilan balik ini harus meminta kredensial kepada pengguna ( baik nama pengguna dan kata sandi atau BLOB autentikasi) dan menyimpan informasi ini di anggota yang sesuai dari struktur DAV_CALLBACK_CRED yang ditunjuk parameter pCallbackCred .

Persyaratan


Klien minimum yang didukung	Windows Vista dengan SP2 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 dengan SP2 [hanya aplikasi desktop]
Target Platform	Windows
Header	davclnt.h

Lihat juga

CredUIPromptForCredentials

CredUIPromptForWindowsCredentials

DAV_CALLBACK_AUTH_BLOB

DAV_CALLBACK_AUTH_UNP

DavFreeCredCallback

Bagikan melalui