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
使用する認証スキームを指定するフラグのビットマスク。
| 値 | 意味 |
|---|---|
|
基本認証を使用します。 |
|
Microsoft NTLM 認証を使用する必要があります。 |
|
パスポート認証 が使用されます。 |
|
Microsoft ダイジェスト認証 が使用されます。 |
|
Microsoft Negotiate を使用します。 |
|
証明書認証が使用されます。 |
|
フォーム ベースの認証を使用する必要があります。 |
[in] dwFlags
WEBDAV サービスが NPAddConnection3 関数を呼び出したときに dwFlags パラメーターで渡されたフラグ。
[in, out] pCallbackCred
DAV_CALLBACK_CRED構造体へのポインター。
[in, out] NextStep
DAVAuthCallback コールバック関数の呼び出しが成功した後に WebDAV クライアントが実行する次のアクションを指定する AUTHNEXTSTEP 列挙値へのポインター。
[out] pFreeCred
DavFreeCredCallback コールバック関数へのポインター。
戻り値
関数が成功した場合、戻り値は ERROR_SUCCESS です。
関数が失敗した場合、戻り値は システム エラー コードです。
解説
DavAuthCallback コールバック関数は、DavRegisterAuthCallback 関数を呼び出して登録する必要があります。
このコールバック関数の登録を解除するには、 DavUnregisterAuthCallback 関数を 使用します。
このコールバック関数は、ユーザーに資格情報 (ユーザー名とパスワード、または認証 BLOB) を求め、pCallbackCred パラメーターが指すDAV_CALLBACK_CRED構造体の適切なメンバーにこの情報を格納する必要があります。
要件
| サポートされている最小のクライアント | Windows Vista と SP2 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 SP2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | davclnt.h |