PFNDAVAUTHCALLBACK 回调函数 (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 结尾的 Unicode 字符串的指针。

[in] lpwzRemoteName

指向以 NULL 结尾的 Unicode 字符串的指针,该字符串包含网络资源的名称。

[in] dwAuthScheme

指定要使用的身份验证方案的标志的位掩码。

Value 含义
DAV_AUTHN_SCHEME_BASIC
0x00000001
将使用基本身份验证。
DAV_AUTHN_SCHEME_NTLM
0x00000002

将使用 Microsoft NTLM 身份验证。

DAV_AUTHN_SCHEME_PASSPORT
0x00000004

将使用 Passport 身份验证

DAV_AUTHN_SCHEME_DIGEST
0x00000008

将使用 Microsoft 摘要式身份验证

DAV_AUTHN_SCHEME_NEGOTIATE
0x00000010

将使用 Microsoft Negotiate

DAV_AUTHN_SCHEME_CERT
0x00010000
将使用证书身份验证。
DAV_AUTHN_SCHEME_FBA
0x00100000
将使用基于表单的身份验证。

[in] dwFlags

WebDAV 服务在调用 NPAddConnection3 函数时在 dwFlags 参数中传递的标志。

[in, out] pCallbackCred

指向 DAV_CALLBACK_CRED 结构的指针。

[in, out] NextStep

指向 AUTHNEXTSTEP 枚举值的指针,该值指定 WebDAV 客户端在成功调用 DavAuthCallback 回调函数后应执行的下一个操作。

[out] pFreeCred

指向 DavFreeCredCallback 回调函数的指针。

返回值

如果函数成功,则返回值为 ERROR_SUCCESS。

如果函数失败,则返回值为 系统错误代码

备注

必须通过调用 DavRegisterAuthCallback 函数来注册 DavAuthCallback 回调 函数。

若要注销此回调函数,请使用 DavUnregisterAuthCallback 函数。

此回调函数应提示用户输入凭据 (用户名和密码身份验证 BLOB) ,并将此信息存储在 pCallbackCred 参数指向的 DAV_CALLBACK_CRED 结构的相应成员中。

要求

   
最低受支持的客户端 Windows Vista SP2 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 SP2 [仅限桌面应用]
目标平台 Windows
标头 davclnt.h

请参阅

CredUIPromptForCredentials

CredUIPromptForWindowsCredentials

DAV_CALLBACK_AUTH_BLOB

DAV_CALLBACK_AUTH_UNP

DavFreeCredCallback