共用方式為

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

旗標的位元遮罩，指定要使用的驗證配置。

值 意義
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

呼叫NPAddConnection3函式時，WebDAV 服務傳入dwFlags參數的旗標。

[in, out] pCallbackCred

DAV_CALLBACK_CRED結構的指標。

[in, out] NextStep

AUTHNEXTSTEP列舉值的指標，指定成功呼叫DavAuthCallback 回呼函式之後，WebDAV 用戶端應該採取的下一個動作。

[out] pFreeCred

DavFreeCredCallback 回呼函式的指標。

傳回值

如果函式成功，傳回值會ERROR_SUCCESS。

如果函式失敗，則傳回值是 系統錯誤碼。

備註

DavAuthCallback 回呼函式必須藉由呼叫DavRegisterAuthCallback函式來註冊。

若要取消註冊此回呼函式，請使用 DavUnregisterAuthCallback 函式。

此回呼函式應該提示使用者輸入認證， (使用者名稱和密碼或驗證 BLOB) ，並將此資訊儲存在pCallbackCred參數所指向之DAV_CALLBACK_CRED結構的適當成員中。

需求

   
最低支援的用戶端 具有 SP2 的 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 SP2 [僅限桌面應用程式]
目標平台 Windows
標頭 davclnt.h

另請參閱

CredUIPromptForCredentials

CredUIPromptForWindowsCredentials

DAV_CALLBACK_AUTH_BLOB

DAV_CALLBACK_AUTH_UNP

DavFreeCredCallback