PFNDAVAUTHCALLBACK callback function (davclnt.h)

The WebDAV client calls the application-defined DavAuthCallback callback function to prompt the user for credentials.

The PFNDAVAUTHCALLBACK type defines a pointer to this callback function. DavAuthCallback is a placeholder for the application-defined function name.

Syntax

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

Parameters

[in] lpwzServerName

A pointer to a NULL-terminated Unicode string that contains the name of the target server.

[in] lpwzRemoteName

A pointer to a NULL-terminated Unicode string that contains the name of the network resource.

[in] dwAuthScheme

A bitmask of flags that specify the authentication schemes to be used.

[in] dwFlags

The flags that the WebDAV service passed in the dwFlags parameter when it called the NPAddConnection3 function.

[in, out] pCallbackCred

A pointer to a DAV_CALLBACK_CRED structure.

[in, out] NextStep

A pointer to an AUTHNEXTSTEP enumeration value that specifies the next action that the WebDAV client should take after a successful call to the DavAuthCallback callback function.

[out] pFreeCred

A pointer to a DavFreeCredCallback callback function.

Return value

If the function succeeds, the return value is ERROR_SUCCESS.

If the function fails, the return value is a system error code.

Remarks

The DavAuthCallback callback function must be registered by calling the DavRegisterAuthCallback function.

To unregister this callback function, use the DavUnregisterAuthCallback function.

This callback function should prompt the user for credentials (either a user name and password or an authentication BLOB) and store this information in the appropriate member of the DAV_CALLBACK_CRED structure that the pCallbackCred parameter points to.

Requirements

See also

CredUIPromptForCredentials

CredUIPromptForWindowsCredentials

DAV_CALLBACK_AUTH_BLOB

DAV_CALLBACK_AUTH_UNP

DavFreeCredCallback