PassportIdentity.LoginUser Metoda

Reference

Definice

Obor názvů:: System.Web.Security

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Přihlásí uživatele buď generováním adresy URL přesměrování 302, nebo iniciací výměny ověřování klientů pracující s Passportem. Tato třída je zastaralá.

Přetížení

LoginUser()	Přihlásí uživatele buď generováním adresy URL pro přesměrování 302, nebo zahájením výměny ověřování klienta pracujícího s Passportem. Tato třída je zastaralá.
LoginUser(String)	Přihlásí uživatele buď generováním adresy URL pro přesměrování 302, nebo zahájením výměny ověřování klienta pracujícího s Passportem. Tato třída je zastaralá.
LoginUser(String, Int32, Boolean, String, Int32, String, Int32, Boolean, Object)	Přihlásí uživatele buď generováním adresy URL přesměrování 302, nebo iniciací výměny ověřování klientů pracující s Passportem. Tato třída je zastaralá.
LoginUser(String, Int32, Int32, String, Int32, String, Int32, Int32, Object)	Přihlásí uživatele buď generováním adresy URL pro přesměrování 302, nebo zahájením výměny ověřování klienta pracujícího s Passportem. Tato třída je zastaralá.

Poznámky

Tato třída je zastaralá a už se nepodporuje. Služba Microsoft Passport Network byla nahrazena službou Windows Live ID.

LoginUser()

Přihlásí uživatele buď generováním adresy URL pro přesměrování 302, nebo zahájením výměny ověřování klienta pracujícího s Passportem. Tato třída je zastaralá.

public:
 int LoginUser();

public int LoginUser ();

member this.LoginUser : unit -> int

Public Function LoginUser () As Integer

Návraty

Int32

Celočíselné kód výsledku.

Poznámky

Tato třída je zastaralá a už se nepodporuje. Služba Microsoft Passport Network byla nahrazena službou Windows Live ID.

Platí pro

LoginUser(String)

Přihlásí uživatele buď generováním adresy URL pro přesměrování 302, nebo zahájením výměny ověřování klienta pracujícího s Passportem. Tato třída je zastaralá.

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

public int LoginUser (string strReturnUrl);

member this.LoginUser : string -> int

Public Function LoginUser (strReturnUrl As String) As Integer

Parametry

strReturnUrl: String

Adresa URL, na kterou by měl přihlašovací server po přihlášení přesměrovat uživatele. Pass null to indikuje, že Passport by měl použít výchozí hodnotu.

Návraty

Int32

Celočíselné kód výsledku.

Poznámky

Tato třída je zastaralá a už se nepodporuje. Služba Microsoft Passport Network byla nahrazena službou Windows Live ID.

Platí pro

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

Přihlásí uživatele buď generováním adresy URL přesměrování 302, nebo iniciací výměny ověřování klientů pracující s Passportem. Tato třída je zastaralá.

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

Parametry

szRetURL: String

Adresa URL, na kterou by měl přihlašovací server po přihlášení přesměrovat uživatele. Pass null to indikuje, že Passport by měl použít výchozí hodnotu.

iTimeWindow: Int32

Hodnota času v sekundách. Předáním -1 označíte, že Passport by měl použít výchozí hodnotu.

fForceLogin: Boolean

true pokud chcete, aby přihlašovací server porovnával iTimeWindow parametr s časem od posledního přihlášení uživatele. false Aby se přihlašovací server srovnal iTimeWindow s časem poslední aktualizace lístku. Předáním -1 označíte, že Passport by měl použít výchozí hodnotu.

szCOBrandArgs: String

Řetězec určující proměnné, které se mají připojit jako proměnné řetězce dotazu k adrese URL stránky skriptu šablony cobranding účastníka. Pass null to indikuje, že Passport by měl použít výchozí hodnotu.

iLangID: Int32

Identifikátor národního prostředí (LCID) určující jazyk, ve kterém se má zobrazit přihlašovací stránka. Předáním -1 označíte, že Passport by měl použít výchozí hodnotu.

strNameSpace: String

Prostor názvů domén, na který chcete směrovat uživatele bez passportů, aby se zaregistrovali. Zadaný prostor názvů se musí zobrazit jako položka "název domény" v dokumentu konfigurace komponenty Partner.xml (CCD). Typický výchozí prostor názvů je "passport.com". Pass null to indikuje, že Passport by měl použít výchozí hodnotu.

iKPP: Int32

Předáním -1 označíte, že Passport by měl použít výchozí hodnotu. Tento parametr je relevantní pouze při implementaci služby Kids Passport; Služba Kids Passport však v současné době nepodporuje použití této metody.

fUseSecureAuth: Boolean

Přihlášení SSL není k dispozici jako možnost na aktuálních serverech pro přihlášení k verzi. Metody Passport Manageru zahrnují parametry přihlášení SSL a můžou být vyžadovány pro syntaxi, ale v současné době se na serveru ignorují. Zkontrolujte, jestli se na webu Passportu neaktualují informace o stavu přihlášení ssl. Předáním -1 označíte, že Passport by měl použít výchozí hodnotu.

oExtraParams: Object

Páry name-value, které se mají vložit přímo do hlavičky ověřování výzvy, konkrétně pro interakci ověřování s podporou Passportu. Pass null to indikuje, že Passport by měl použít výchozí hodnotu.

Návraty

Int32

Celočíselné kód výsledku.

Příklady

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

Poznámky

Tato třída je zastaralá a už se nepodporuje. Služba Microsoft Passport Network byla nahrazena službou Windows Live ID.

Platí pro

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

Přihlásí uživatele buď generováním adresy URL pro přesměrování 302, nebo zahájením výměny ověřování klienta pracujícího s Passportem. Tato třída je zastaralá.

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

Parametry

szRetURL: String

Adresa URL, na kterou by měl přihlašovací server po přihlášení přesměrovat uživatele. Pass null to indikuje, že Passport by měl použít výchozí hodnotu.

iTimeWindow: Int32

Hodnota času v sekundách. Předáním -1 označíte, že Passport by měl použít výchozí hodnotu.

fForceLogin: Int32

Určuje, jestli má přihlašovací server porovnat iTimeWindow parametr s časem od posledního přihlášení uživatele nebo proti poslednímu aktualizaci lístku. Předáním -1 označíte, že Passport by měl použít výchozí hodnotu.

szCOBrandArgs: String

iLangID: Int32

Identifikátor národního prostředí (LCID) určující jazyk, ve kterém se má zobrazit přihlašovací stránka. Předáním -1 označíte, že Passport by měl použít výchozí hodnotu.

strNameSpace: String

iKPP: Int32

iUseSecureAuth: Int32

oExtraParams: Object

Návraty

Int32

Celočíselné kód výsledku.

Poznámky

Tato třída je zastaralá a už se nepodporuje. Služba Microsoft Passport Network byla nahrazena službou Windows Live ID.

Platí pro

Sdílet prostřednictvím

PassportIdentity.LoginUser Metoda

Definice

Přetížení

Poznámky

LoginUser()

Návraty

Poznámky

Platí pro

LoginUser(String)

Parametry

Návraty

Poznámky

Platí pro

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

Parametry

Návraty

Příklady

Poznámky

Platí pro

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

Parametry

Návraty

Poznámky

Platí pro

Další materiály