PassportIdentity.LoginUser Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Web.Security

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Consente l'accesso all'utente mediante la generazione di un URL di reindirizzamento con codice 302 o l'avvio di uno scambio di autenticazione client compatibile con Passport. Questa classe è deprecata.

Overload

LoginUser()	Consente l'accesso all'utente mediante la generazione di un URL di reindirizzamento con codice 302 o l'avvio di uno scambio di autenticazione client compatibile con Passport. Questa classe è deprecata.
LoginUser(String)	Consente l'accesso all'utente mediante la generazione di un URL di reindirizzamento con codice 302 o l'avvio di uno scambio di autenticazione client compatibile con Passport. Questa classe è deprecata.
LoginUser(String, Int32, Boolean, String, Int32, String, Int32, Boolean, Object)	Consente l'accesso all'utente mediante la generazione di un URL di reindirizzamento con codice 302 o l'avvio di uno scambio di autenticazione client compatibile con Passport. Questa classe è deprecata.
LoginUser(String, Int32, Int32, String, Int32, String, Int32, Int32, Object)	Consente l'accesso all'utente mediante la generazione di un URL di reindirizzamento con codice 302 o l'avvio di uno scambio di autenticazione client compatibile con Passport. Questa classe è deprecata.

Commenti

Questa classe è stata deprecata e non è più supportata. Microsoft Passport Network è stato sostituito da Windows Live ID.

LoginUser()

public:
 int LoginUser();

public int LoginUser ();

member this.LoginUser : unit -> int

Public Function LoginUser () As Integer

Restituisce

Int32

Codice restituito da un intero.

Commenti

Questa classe è stata deprecata e non è più supportata. Microsoft Passport Network è stato sostituito da Windows Live ID.

Si applica 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

Parametri

strReturnUrl: String

URL a cui gli utenti vengono reindirizzati dal server di accesso al termine della registrazione. Passare null per indicare che Passport deve usare il valore predefinito.

Restituisce

Int32

Codice restituito da un intero.

Commenti

Questa classe è stata deprecata e non è più supportata. Microsoft Passport Network è stato sostituito da Windows Live ID.

Si applica 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

Parametri

szRetURL: String

URL a cui gli utenti vengono reindirizzati dal server di accesso al termine della registrazione. Passare null per indicare che Passport deve usare il valore predefinito.

iTimeWindow: Int32

Valore relativo al tempo, in secondi. Passare -1 per indicare che Passport deve usare il valore predefinito.

fForceLogin: Boolean

true per fare in modo che il server di accesso confronti il parametro iTimeWindow al periodo trascorso dall'ultima registrazione dell'utente. false per fare in modo che il server di accesso confronti iTimeWindow all'ultimo aggiornamento del ticket. Passare -1 per indicare che Passport deve usare il valore predefinito.

szCOBrandArgs: String

Stringa in cui vengono specificate le variabili da aggiungere come variabili di stringa di query all'URL della pagina di script Cobranding Template del partecipante. Passare null per indicare che Passport deve usare il valore predefinito.

iLangID: Int32

Identificatore delle impostazioni locali (LCID) che consente di specificare la lingua di visualizzazione della pagina di accesso. Passare -1 per indicare che Passport deve usare il valore predefinito.

strNameSpace: String

Spazio dei nomi di dominio a cui si desidera indirizzare gli utenti privi di Passport per la registrazione. È necessario che lo spazio dei nomi specificato venga visualizzato come voce "nome dominio" nel documento di configurazione del componente (CCD, Component Configuration Document) Partner.xml. Lo spazio dei nomi predefinito generalmente usato è "passport.com". Passare null per indicare che Passport deve usare il valore predefinito.

iKPP: Int32

Passare -1 per indicare che Passport deve usare il valore predefinito. Questo parametro risulta rilevante solo quando si implementa il servizio Kids Passport. Il servizio Kids Passport tuttavia attualmente non supporta l'utilizzo di questo metodo.

fUseSecureAuth: Boolean

L'accesso SSL non è disponibile come opzione nelle versioni correnti dei server di accesso. I metodi di Passport Manager includono parametri di accesso SSL che possono essere necessari per la sintassi, ma vengono attualmente ignorati a livello del server. Verificare nel sito Web Passport la disponibilità di aggiornamenti sullo stato dell'accesso SSL. Passare -1 per indicare che Passport deve usare il valore predefinito.

oExtraParams: Object

Coppie nome-valore da inserire direttamente nell'intestazione della richiesta di autenticazione, specificamente per l'interazione di autenticazione compatibile con Passport. Passare null per indicare che Passport deve usare il valore predefinito.

Restituisce

Int32

Codice restituito da un intero.

Esempio

<!-- 
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>

Commenti

Questa classe è stata deprecata e non è più supportata. Microsoft Passport Network è stato sostituito da Windows Live ID.

Si applica 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

Parametri

szRetURL: String

URL a cui gli utenti vengono reindirizzati dal server di accesso al termine della registrazione. Passare null per indicare che Passport deve usare il valore predefinito.

iTimeWindow: Int32

Valore relativo al tempo, in secondi. Passare -1 per indicare che Passport deve usare il valore predefinito.

fForceLogin: Int32

Indica se è necessario che il server di accesso confronti il parametro iTimeWindow con il periodo trascorso dall'ultima registrazione dell'utente o con l'ora dell'ultimo aggiornamento del ticket. Passare -1 per indicare che Passport deve usare il valore predefinito.

szCOBrandArgs: String

iLangID: Int32

strNameSpace: String

iKPP: Int32

iUseSecureAuth: Int32

oExtraParams: Object

Restituisce

Int32

Codice restituito da un intero.

Commenti

Questa classe è stata deprecata e non è più supportata. Microsoft Passport Network è stato sostituito da Windows Live ID.

Si applica a

Condividi tramite

PassportIdentity.LoginUser Metodo

Definizione

Overload

Commenti

LoginUser()

Restituisce

Commenti

Si applica a

LoginUser(String)

Parametri

Restituisce

Commenti

Si applica a

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

Parametri

Restituisce

Esempio

Commenti

Si applica a

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

Parametri

Restituisce

Commenti

Si applica a

Risorse aggiuntive