Authentication.Login Method
Utiliza en un sistema de autenticación basada en formularios para establecer una cookie de autenticación o, si hay un problema con el inicio de sesión, devolver un código de error.
Web Service: AuthenticationWeb Reference: http://<Site>/_vti_bin/Authentication.asmx
Syntax
'Declaración
<SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/Login", RequestNamespace:="https://schemas.microsoft.com/sharepoint/soap/", ResponseNamespace:="https://schemas.microsoft.com/sharepoint/soap/", Use:=SoapBindingUse.Literal, ParameterStyle:=SoapParameterStyle.Wrapped)> _
PublicFunctionLogin ( _
usernameAsString, _
passwordAsString _
) AsLoginResult
'Uso
DiminstanceAsAuthenticationDimusernameAsStringDimpasswordAsStringDimreturnValueAsLoginResultreturnValue = instance.Login(username, password)
[SoapDocumentMethodAttribute("https://schemas.microsoft.com/sharepoint/soap/Login", RequestNamespace="https://schemas.microsoft.com/sharepoint/soap/", ResponseNamespace="https://schemas.microsoft.com/sharepoint/soap/", Use=SoapBindingUse.Literal, ParameterStyle=SoapParameterStyle.Wrapped)]
publicLoginResultLogin (
stringusername,
stringpassword
)
Parameters
- username
Nombre de inicio de sesión del usuario para el sitio de SharePoint.
- password
Contraseña del usuario.
Return Value
Una estructura LoginResult que contiene ya sea un error código en su ErrorCode Campo o el nombre de una cookie de autenticación en su propiedad CookieName.
Remarks
The Login method uses the authentication services provided by the Membership and FormsAuthentication classes that are provided in Microsoft ASP.NET 2.0.
La cookie contiene un vale de autenticación que se utilizará para autenticar las solicitudes posteriores en el servidor.
Deberá imponer las restricciones de formato o longitud en el nombre de usuario o contraseña como, por ejemplo, solicitar contraseñas para incluir un numeral o signo de puntuación. Si es así, debe proporcionar su propia lógica de validación antes de pasar el método Login el nombre de usuario y contraseña. Por motivos de rendimiento, este paso de validación debe realizarse de forma local en equipos cliente.
See Also
Reference
Authentication Class
Authentication Members
Authentication Web Service
Membership
FormsAuthentication