Función de devolución de llamada PFNDAVAUTHCALLBACK (davclnt.h)
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 |
|---|---|
|
Se va a usar la autenticación básica. |
|
Se va a usar la autenticación NTLM de Microsoft. |
|
La autenticación de Passport se va a usar. |
|
La autenticación implícita de Microsoft se va a usar. |
|
Microsoft Negotiate se va a usar. |
|
Se va a usar la autenticación de certificado. |
|
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 |