ホーム › NetworkManagement.WebDav › PFNDAVAUTHCALLBACK

PFNDAVAUTHCALLBACK

コールバック

シグネチャ

DWORD PFNDAVAUTHCALLBACK(
    LPWSTR lpwzServerName,
    LPWSTR lpwzRemoteName,
    DWORD dwAuthScheme,
    DWORD dwFlags,
    DAV_CALLBACK_CRED* pCallbackCred,
    AUTHNEXTSTEP* NextStep,
    PFNDAVAUTHCALLBACK_FREECRED* pFreeCred
);

パラメーター

フィールド

型

説明

lpwzServerName

LPWSTR

対象サーバーの名前を格納した NULL 終端の Unicode 文字列へのポインターです。

lpwzRemoteName

LPWSTR

ネットワークリソースの名前を格納した NULL 終端の Unicode 文字列へのポインターです。

dwAuthScheme

DWORD

使用する認証スキームを指定するフラグのビットマスクです。

値	意味
DAV_AUTHN_SCHEME_BASIC 0x00000001	基本認証を使用します。
DAV_AUTHN_SCHEME_NTLM 0x00000002	Microsoft NTLM 認証を使用します。
DAV_AUTHN_SCHEME_PASSPORT 0x00000004	Passport 認証を使用します。
DAV_AUTHN_SCHEME_DIGEST 0x00000008	Microsoft Digest 認証を使用します。
DAV_AUTHN_SCHEME_NEGOTIATE 0x00000010	Microsoft Negotiate を使用します。
DAV_AUTHN_SCHEME_CERT 0x00010000	証明書認証を使用します。
DAV_AUTHN_SCHEME_FBA 0x00100000	フォームベース認証を使用します。

dwFlags

DWORD

WebDAV サービスが NPAddConnection3 関数を呼び出したときに、dwFlags パラメーターで渡したフラグです。

pCallbackCred

DAV_CALLBACK_CRED*

DAV_CALLBACK_CRED 構造体へのポインターです。

NextStep

AUTHNEXTSTEP*

DavAuthCallback コールバック関数の呼び出しに成功した後に WebDAV クライアントが実行すべき次の動作を指定する AUTHNEXTSTEP 列挙値へのポインターです。

pFreeCred

PFNDAVAUTHCALLBACK_FREECRED*

DavFreeCredCallback コールバック関数へのポインターです。

公式ドキュメント

WebDAV クライアントは、ユーザーに資格情報の入力を求めるために、アプリケーション定義の DavAuthCallback コールバック関数を呼び出します。

PFNDAVAUTHCALLBACK 型は、このコールバック関数へのポインターを定義します。DavAuthCallback は、アプリケーション定義の関数名のプレースホルダーです。

戻り値

関数が成功した場合、戻り値は ERROR_SUCCESS です。

関数が失敗した場合、戻り値はシステムエラーコードです。

解説(Remarks)

DavAuthCallback コールバック関数は、DavRegisterAuthCallback 関数を呼び出して登録しておく必要があります。

このコールバック関数の登録を解除するには、DavUnregisterAuthCallback 関数を使用します。

このコールバック関数は、ユーザーに資格情報(ユーザー名とパスワード、または認証 BLOB)の入力を求め、その情報を pCallbackCred パラメーターが指す DAV_CALLBACK_CRED 構造体の適切なメンバーに格納する必要があります。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)