Función de devolución de llamada PFNDAVAUTHCALLBACK (davclnt.h)

Artículo
08/23/2023

El cliente webDAV llama a la función de devolución de llamada DavAuthCallback definida por la aplicación para solicitar al usuario las credenciales.

El tipo PFNDAVAUTHCALLBACK define un puntero a esta función de devolución de llamada. DavAuthCallback es un marcador de posición para el nombre de función definido por la aplicación.

Sintaxis

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

Parámetros

[in] lpwzServerName

Puntero a una cadena Unicode terminada en NULL que contiene el nombre del servidor de destino.

[in] lpwzRemoteName

Puntero a una cadena Unicode terminada en NULL que contiene el nombre del recurso de red.

[in] dwAuthScheme

Máscara de bits de marcas que especifican los esquemas de autenticación que se van a usar.

Valor	Significado
DAV_AUTHN_SCHEME_BASIC 0x00000001	Se va a usar la autenticación básica.
DAV_AUTHN_SCHEME_NTLM 0x00000002	Se va a usar la autenticación NTLM de Microsoft.
DAV_AUTHN_SCHEME_PASSPORT 0x00000004	La autenticación de Passport se va a usar.
DAV_AUTHN_SCHEME_DIGEST 0x00000008	La autenticación implícita de Microsoft se va a usar.
DAV_AUTHN_SCHEME_NEGOTIATE 0x00000010	Microsoft Negotiate se va a usar.
DAV_AUTHN_SCHEME_CERT 0x00010000	Se va a usar la autenticación de certificado.
DAV_AUTHN_SCHEME_FBA 0x00100000	La autenticación basada en formularios se va a usar.

[in] dwFlags

Marcas que el servicio WebDAV pasó en el parámetro dwFlags cuando llamó a la función NPAddConnection3 .

[in, out] pCallbackCred

Puntero a una estructura de DAV_CALLBACK_CRED .

[in, out] NextStep

Puntero a un valor de enumeración AUTHNEXTSTEP que especifica la siguiente acción que el cliente WebDAV debe realizar después de una llamada correcta a la función de devolución de llamada DavAuthCallback .

[out] pFreeCred

Puntero a una función de devolución de llamada DavFreeCredCallback .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es ERROR_SUCCESS.

Si se produce un error en la función, el valor devuelto es un código de error del sistema.

Comentarios

La función de devolución de llamada DavAuthCallback debe estar registrada llamando a la función DavRegisterAuthCallback .

Para anular el registro de esta función de devolución de llamada, use la función DavUnregisterAuthCallback .

Esta función de devolución de llamada debe solicitar al usuario credenciales (ya sea un nombre de usuario y una contraseña o un BLOB de autenticación) y almacenar esta información en el miembro adecuado de la estructura DAV_CALLBACK_CRED a la que apunta el parámetro pCallbackCred .

Requisitos


Cliente mínimo compatible	Windows Vista con SP2 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 con SP2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	davclnt.h