PassportIdentity.LoginUser Método

Referencia

Definición

Espacio de nombres:: System.Web.Security

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Inicia la sesión del usuario, bien generando una dirección URL de redireccionamiento 302 o bien iniciando un intercambio de autenticación del cliente que reconozca Passport. Esta clase está en desuso.

Sobrecargas

LoginUser()	Inicia la sesión del usuario, bien generando una dirección URL de redireccionamiento 302 o bien iniciando un intercambio de autenticación de un cliente que reconozca Passport. Esta clase está en desuso.
LoginUser(String)	Inicia la sesión del usuario, bien generando una dirección URL de redireccionamiento 302 o bien iniciando un intercambio de autenticación de un cliente que reconozca Passport. Esta clase está en desuso.
LoginUser(String, Int32, Boolean, String, Int32, String, Int32, Boolean, Object)	Inicia la sesión del usuario, bien generando una dirección URL de redireccionamiento 302 o bien iniciando un intercambio de autenticación del cliente que reconozca Passport. Esta clase está en desuso.
LoginUser(String, Int32, Int32, String, Int32, String, Int32, Int32, Object)	Inicia la sesión del usuario, bien generando una dirección URL de redireccionamiento 302 o bien iniciando un intercambio de autenticación de un cliente que reconozca Passport. Esta clase está en desuso.

Comentarios

Esta clase está en desuso y ya no se admite. Microsoft Passport Network fue reemplazado por Windows Live ID.

LoginUser()

Inicia la sesión del usuario, bien generando una dirección URL de redireccionamiento 302 o bien iniciando un intercambio de autenticación de un cliente que reconozca Passport. Esta clase está en desuso.

public:
 int LoginUser();

public int LoginUser ();

member this.LoginUser : unit -> int

Public Function LoginUser () As Integer

Devoluciones

Int32

Código de resultado de número entero.

Comentarios

Esta clase está en desuso y ya no se admite. Microsoft Passport Network fue reemplazado por Windows Live ID.

Se aplica a

LoginUser(String)

public:
 int LoginUser(System::String ^ strReturnUrl);

public int LoginUser (string strReturnUrl);

member this.LoginUser : string -> int

Public Function LoginUser (strReturnUrl As String) As Integer

Parámetros

strReturnUrl: String

Dirección URL a la que el servidor de inicio de sesión debe redirigir a los usuarios una vez iniciada la sesión. Se pasa null para indicar que Passport debe usar el valor predeterminado.

Devoluciones

Int32

Código de resultado de número entero.

Comentarios

Esta clase está en desuso y ya no se admite. Microsoft Passport Network fue reemplazado por Windows Live ID.

Se aplica a

LoginUser(String, Int32, Boolean, String, Int32, String, Int32, Boolean, Object)

public:
 int LoginUser(System::String ^ szRetURL, int iTimeWindow, bool fForceLogin, System::String ^ szCOBrandArgs, int iLangID, System::String ^ strNameSpace, int iKPP, bool fUseSecureAuth, System::Object ^ oExtraParams);

public int LoginUser (string szRetURL, int iTimeWindow, bool fForceLogin, string szCOBrandArgs, int iLangID, string strNameSpace, int iKPP, bool fUseSecureAuth, object oExtraParams);

member this.LoginUser : string * int * bool * string * int * string * int * bool * obj -> int

Public Function LoginUser (szRetURL As String, iTimeWindow As Integer, fForceLogin As Boolean, szCOBrandArgs As String, iLangID As Integer, strNameSpace As String, iKPP As Integer, fUseSecureAuth As Boolean, oExtraParams As Object) As Integer

Parámetros

szRetURL: String

Dirección URL a la que el servidor de inicio de sesión debe redirigir a los usuarios una vez iniciada la sesión. Se pasa null para indicar que Passport debe usar el valor predeterminado.

iTimeWindow: Int32

Valor de tiempo en segundos. Se pasa -1 para indicar que Passport debe usar el valor predeterminado.

fForceLogin: Boolean

true para que el servidor de inicio de sesión compare el parámetro iTimeWindow con el tiempo transcurrido desde que el usuario se conectó por última vez; false para que el servidor de inicio de sesión compare iTimeWindow con la última vez que se actualizó el vale. Se pasa -1 para indicar que Passport debe usar el valor predeterminado.

szCOBrandArgs: String

Cadena que especifica variables que se van a agregar como variables de cadena de consulta a la dirección URL de la página de script Cobranding Template del participante. Se pasa null para indicar que Passport debe usar el valor predeterminado.

iLangID: Int32

Identificador de configuración regional (LCID) que especifica el idioma en que debe mostrarse la página de inicio de sesión. Se pasa -1 para indicar que Passport debe usar el valor predeterminado.

strNameSpace: String

Espacio de nombres de dominio al que desee dirigir a los usuarios sin registros en Passport. El espacio de nombres especificado debe aparecer como una entrada "nombre de dominio" en el Documento de configuración de componentes (CCD) Partner.xml. El espacio de nombres predeterminado que se suele usar es "passport.com". Se pasa null para indicar que Passport debe usar el valor predeterminado.

iKPP: Int32

Se pasa -1 para indicar que Passport debe usar el valor predeterminado. Este parámetro solo es relevante cuando se implementa el servicio Kids Passport, aunque actualmente no es compatible con este método.

fUseSecureAuth: Boolean

El inicio de sesión SSL no está disponible como opción en los servidores de inicio de sesión de la versión actual. Los métodos del administrador de Passport incluyen parámetros de inicio de sesión SSL y pueden ser necesarios por motivos de sintaxis, pero el servidor no los tiene en cuenta actualmente. Compruebe el sitio web de Passport para ver si hay novedades sobre el estado del inicio de sesión SSL. Se pasa -1 para indicar que Passport debe usar el valor predeterminado.

oExtraParams: Object

Pares nombre-valor que se van a insertar directamente en el encabezado de autenticación por desafío, específicamente para la interacción de autenticación mediante reconocimiento de Passport. Se pasa null para indicar que Passport debe usar el valor predeterminado.

Devoluciones

Int32

Código de resultado de número entero.

Ejemplos

<!-- 
This example demonstrates implementing the soft sign-in authentication approach. 
In order for the example to work, the following requirements must be met. 
You can find details on these requirements in the Passport SDK documentation.

1. You must modify the Web.config file associated with this page so that 
authentication mode is set to "Passport".
2. You must have the Passport SDK installed.
3. You must have a Passport Site ID for the site where your page resides. 
If your Site ID is in the PREP environment, you will also need a PREP Passport.
4. You must have installed the encryption key you received after registering 
your site and receiving a site ID.
5. You must have the Passport Manager object settings correctly configured for 
your site.
-->

<!-- 
This example demonstrates implementing the soft sign-in authentication approach. 
In order for the example to work, the following requirements must be met. 
You can find details on these requirements in the Passport SDK documentation.

1. You must modify the Web.config file associated with this page so that 
authentication mode is set to "Passport".
2. You must have the Passport SDK installed.
3. You must have a Passport Site ID for the site where your page resides. 
If your Site ID is in the PREP environment, you will also need a PREP Passport.
4. You must have installed the encryption key you received after registering your 
site and receiving a site ID.
5. You must have the Passport Manager object settings correctly configured for your site.
-->

<%@ Page language="c#" AutoEventWireup="true" %>
<%@ Import Namespace="System.Drawing" %>
<%@ Import Namespace="System.Web.Security" %>
<%@ Import Namespace="System.Runtime.InteropServices" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
    private void Page_Load(object sender, System.EventArgs e)
    {
        try 
        {
            // Determine whether Passport is the type of authentication
            // this page is set to use. (Authentication information
            // is set in the Web.config file.)
            if (!(this.Context.User.Identity is PassportIdentity))
            {
                // If this page isn't set to use Passport authentication,
                // quit now.
                this.Response.Write("Error: Passport authentication failed. " + 
                    "Make sure that the Passport SDK is installed " +
                    "and your Web.config file is configured correctly.");
                return;
            }

            // Expire the page to avoid the browser's cache.
           Response.Cache.SetNoStore(); 


            // Get a version of the Identity value that is cast as type
            // PassportIdentity. 
//<Snippet4>
//<Snippet5>
//<Snippet6>
            PassportIdentity identity = (this.Context.User.Identity as PassportIdentity);    
            // Determine whether the user is already signed in with a valid
            // and current ticket. Passing -1 for the parameter values 
            // indicates the default values will be used.
            if (identity.GetIsAuthenticated(-1, -1, -1))
            {
                this.Response.Write("Welcome to the site.<br /><br />");
                // Print the Passport sign in button on the screen.
                this.Response.Write(identity.LogoTag2());
//</Snippet6>
                // Make sure the user has core profile information before
                // trying to access it.
                if (identity.HasProfile("core"))
                {
                    this.Response.Write("<b>You have been authenticated as " + 
                        "Passport identity:" + identity.Name + "</b></p>");
                }
            }
//</Snippet5>            
    
            // Determine whether the user has a ticket.
            else if (identity.HasTicket)
            {
                // If the user has a ticket but wasn't authenticated, that 
                // means the ticket is stale, so the login needs to be refreshed.
                // Passing true as the fForceLogin parameter value indicates that 
                // silent refresh will be accepted.
                identity.LoginUser(null, -1, true, null, -1, null, -1, true, null);
            }
//</Snippet4>

            // If the user does not already have a ticket, ask the user
            // to sign in.
            else
            {
                this.Response.Write("Please sign in using the link below.<br /><br />");
                // Print the Passport sign in button on the screen.
                this.Response.Write(identity.LogoTag2());
            }
        }
        catch (System.Runtime.InteropServices.COMException comError)
        {
            this.Response.Write("An error occurred while working with the " +
                "Passport SDK.");
        }
    }
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
    <head>
    <title>ASP.NET Example</title>
</head>
    <body>
        <form id="form1" runat="server">
        </form>
    </body>
</html>

<%@ Page language="VB" AutoEventWireup="true" %>
<%@ Import Namespace="System.Drawing" %>
<%@ Import Namespace="System.Web.Security" %>
<%@ Import Namespace="System.Runtime.InteropServices" %>


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<script runat="server">
    Private Sub Page_Load(sender As Object, e As System.EventArgs)
        Try 
            ' Determine whether Passport is the type of authentication
            ' this page is set to use. (Authentication information
            ' is set in the Web.config file.)
            If Not TypeOf(Me.Context.User.Identity) Is PassportIdentity Then
                ' If this page isn't set to use Passport authentication,
                ' quit now.
                 Me.Response.Write("Error: Passport authentication failed. " & _
                     "Make sure that the Passport SDK is installed and your " & _
                     "Web.config file is configured correctly.")
                Return
            End If

            ' Expire the page to avoid the browser's cache.
            Response.Cache.SetNoStore()
            
            ' Get a version of the Identity value that is cast as type
            ' PassportIdentity. 
'<Snippet4>
'<Snippet5>
'<Snippet6>
            Dim identity As PassportIdentity = Me.Context.User.Identity
            ' Determine whether the user is already signed in with a valid
            ' and current ticket. Passing -1 for the parameter values 
            ' indicates the default values will be used.
            If (identity.GetIsAuthenticated(-1, -1, -1)) Then
                Me.Response.Write("Welcome to the site.<br /><br />")
                ' Print the Passport sign in button on the screen.
                Me.Response.Write(identity.LogoTag2())
'</Snippet6>
                ' Make sure the user has core profile information before
                ' trying to access it.
                If (identity.HasProfile("core")) Then
                    Me.Response.Write("<b>You have been authenticated as " & _ 
                    "Passport identity:" & identity.Name & "</b></p>")
                End If
'</Snippet5>            
    
            ' Determine whether the user has a ticket.
            ElseIf identity.HasTicket Then
                ' If the user has a ticket but wasn't authenticated, that 
                ' means the ticket is stale, so the login needs to be refreshed.
                ' Passing true as the fForceLogin parameter value indicates that 
                ' silent refresh will be accepted.
                identity.LoginUser(Nothing, -1, True, Nothing, -1, Nothing, _
                    -1, True, Nothing)
'</Snippet4>

            ' If the user does not already have a ticket, ask the user
            ' to sign in.
            Else
                Me.Response.Write("Please sign in using the link below.<br /><br />")
                ' Print the Passport sign in button on the screen.
                Me.Response.Write(identity.LogoTag2())
            End If

        Catch comError As System.Runtime.InteropServices.COMException
            Me.Response.Write("An error occurred while working with the " & _
                "Passport SDK. The following result was returned: " & _
                comError.ErrorCode)
        End Try
    End Sub
</script>
<html xmlns="http://www.w3.org/1999/xhtml" >
    <head>
    <title>ASP.NET Example</title>
</head>

    <body>
        <form id="form1" runat="server">
        </form>
    </body>
</html>

Comentarios

Esta clase está en desuso y ya no se admite. Microsoft Passport Network fue reemplazado por Windows Live ID.

Se aplica a

LoginUser(String, Int32, Int32, String, Int32, String, Int32, Int32, Object)

public:
 int LoginUser(System::String ^ szRetURL, int iTimeWindow, int fForceLogin, System::String ^ szCOBrandArgs, int iLangID, System::String ^ strNameSpace, int iKPP, int iUseSecureAuth, System::Object ^ oExtraParams);

public int LoginUser (string szRetURL, int iTimeWindow, int fForceLogin, string szCOBrandArgs, int iLangID, string strNameSpace, int iKPP, int iUseSecureAuth, object oExtraParams);

member this.LoginUser : string * int * int * string * int * string * int * int * obj -> int

Public Function LoginUser (szRetURL As String, iTimeWindow As Integer, fForceLogin As Integer, szCOBrandArgs As String, iLangID As Integer, strNameSpace As String, iKPP As Integer, iUseSecureAuth As Integer, oExtraParams As Object) As Integer

Parámetros

szRetURL: String

Dirección URL a la que el servidor de inicio de sesión debe redirigir a los usuarios una vez iniciada la sesión. Se pasa null para indicar que Passport debe usar el valor predeterminado.

iTimeWindow: Int32

Valor de tiempo en segundos. Se pasa -1 para indicar que Passport debe usar el valor predeterminado.

fForceLogin: Int32

Indica si el servidor de inicio de sesión debe comparar el parámetro iTimeWindow con el tiempo transcurrido desde que el usuario inició sesión por última vez o con la última vez que se actualizó el vale. Se pasa -1 para indicar que Passport debe usar el valor predeterminado.

szCOBrandArgs: String

iLangID: Int32

Identificador de configuración regional (LCID) que especifica el idioma en que debe mostrarse la página de inicio de sesión. Se pasa -1 para indicar que Passport debe usar el valor predeterminado.

strNameSpace: String

iKPP: Int32

iUseSecureAuth: Int32

oExtraParams: Object

Devoluciones

Int32

Código de resultado de número entero.

Comentarios

Esta clase está en desuso y ya no se admite. Microsoft Passport Network fue reemplazado por Windows Live ID.

Se aplica a

PassportIdentity.LoginUser Método

Definición

Sobrecargas

Comentarios

LoginUser()

Devoluciones

Comentarios

Se aplica a

LoginUser(String)

Parámetros

Devoluciones

Comentarios

Se aplica a

LoginUser(String, Int32, Boolean, String, Int32, String, Int32, Boolean, Object)

Parámetros

Devoluciones

Ejemplos

Comentarios

Se aplica a

LoginUser(String, Int32, Int32, String, Int32, String, Int32, Int32, Object)

Parámetros

Devoluciones

Comentarios

Se aplica a

Comentarios

Recursos adicionales