Freigeben über


PassportIdentity.LoginUser Methode

Definition

Meldet den Benutzer an, indem entweder eine 302-Umleitungs-URL generiert wird oder ein Client-Authentifizierungsaustausch initiiert wird, der Passport unterstützt. Diese Klasse ist veraltet.

Überlädt

LoginUser()

Meldet den Benutzer an, indem entweder eine 302-Umleitungs-URL generiert oder ein Client-Authentifizierungsaustausch initiiert wird, der Passport unterstützt. Diese Klasse ist veraltet.

LoginUser(String)

Meldet den Benutzer an, indem entweder eine 302-Umleitungs-URL generiert oder ein Client-Authentifizierungsaustausch initiiert wird, der Passport unterstützt. Diese Klasse ist veraltet.

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

Meldet den Benutzer an, indem entweder eine 302-Umleitungs-URL generiert wird oder ein Client-Authentifizierungsaustausch initiiert wird, der Passport unterstützt. Diese Klasse ist veraltet.

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

Meldet den Benutzer an, indem entweder eine 302-Umleitungs-URL generiert oder ein Client-Authentifizierungsaustausch initiiert wird, der Passport unterstützt. Diese Klasse ist veraltet.

Hinweise

Diese Klasse wurde veraltet und wird nicht mehr unterstützt. Microsoft Passport Network wurde durch Windows Live ID ersetzt.

LoginUser()

Meldet den Benutzer an, indem entweder eine 302-Umleitungs-URL generiert oder ein Client-Authentifizierungsaustausch initiiert wird, der Passport unterstützt. Diese Klasse ist veraltet.

public:
 int LoginUser();
public int LoginUser ();
member this.LoginUser : unit -> int
Public Function LoginUser () As Integer

Gibt zurück

Int32

Ein ganzzahliger Ergebniscode.

Hinweise

Diese Klasse wurde veraltet und wird nicht mehr unterstützt. Microsoft Passport Network wurde durch Windows Live ID ersetzt.

Gilt für

LoginUser(String)

Meldet den Benutzer an, indem entweder eine 302-Umleitungs-URL generiert oder ein Client-Authentifizierungsaustausch initiiert wird, der Passport unterstützt. Diese Klasse ist veraltet.

public:
 int LoginUser(System::String ^ strReturnUrl);
public int LoginUser (string strReturnUrl);
member this.LoginUser : string -> int
Public Function LoginUser (strReturnUrl As String) As Integer

Parameter

strReturnUrl
String

Die URL, zu der der Anmeldeserver Benutzer nach abgeschlossener Anmeldung umleiten soll. Übergeben Sie null, um anzuzeigen, dass Passport den Standardwert verwenden soll.

Gibt zurück

Int32

Ein ganzzahliger Ergebniscode.

Hinweise

Diese Klasse wurde veraltet und wird nicht mehr unterstützt. Microsoft Passport Network wurde durch Windows Live ID ersetzt.

Gilt für

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

Meldet den Benutzer an, indem entweder eine 302-Umleitungs-URL generiert wird oder ein Client-Authentifizierungsaustausch initiiert wird, der Passport unterstützt. Diese Klasse ist veraltet.

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

Parameter

szRetURL
String

Die URL, zu der der Anmeldeserver Benutzer nach abgeschlossener Anmeldung umleiten soll. Übergeben Sie null, um anzuzeigen, dass Passport den Standardwert verwenden soll.

iTimeWindow
Int32

Der Zeitwert in Sekunden. Übergeben Sie –1, um anzuzeigen, dass Passport den Standardwert verwenden soll.

fForceLogin
Boolean

true, wenn der Anmeldeserver den iTimeWindow-Parameter mit dem Zeitpunkt vergleichen soll, an dem sich der Benutzer zuletzt angemeldet hat; false, wenn der Anmeldeserver iTimeWindow mit dem Zeitpunkt der letzten Aktualisierung des Tickets vergleichen soll. Übergeben Sie –1, um anzuzeigen, dass Passport den Standardwert verwenden soll.

szCOBrandArgs
String

Eine Zeichenfolge, die Variablen angibt, die als Abfragezeichenfolgenvariablen an die URL der Cobranding-Vorlagenskriptseite des Teilnehmers angefügt werden sollen. Übergeben Sie null, um anzuzeigen, dass Passport den Standardwert verwenden soll.

iLangID
Int32

Ein Gebietsschemabezeichner (LCID, Locale Identifier), der die Sprache angibt, in der die Anmeldeseite angezeigt werden soll. Übergeben Sie –1, um anzuzeigen, dass Passport den Standardwert verwenden soll.

strNameSpace
String

Ein Domänennamespace, an den Benutzer ohne Passports zum Registrieren geleitet werden sollen. Der angegebene Namespace muss als "domain name"-Eintrag im CCD (Component Configuration Document) Partner.xml vorhanden sein. Der übliche Standardnamespace lautet "passport.com". Übergeben Sie null, um anzuzeigen, dass Passport den Standardwert verwenden soll.

iKPP
Int32

Übergeben Sie –1, um anzuzeigen, dass Passport den Standardwert verwenden soll. Dieser Parameter ist nur bei der Implementierung des Kids Passport-Dienstes relevant, derzeit kann der Kids Passport-Dienst die Verwendung dieser Methode jedoch nicht unterstützen.

fUseSecureAuth
Boolean

SSL-Anmeldung ist als Option bei Anmeldeservern der aktuellen Version nicht verfügbar. Zu den Methoden des Passport-Managers gehören SSL-Anmeldeparameter, die für die Syntax erforderlich sein können, aber derzeit vom Server ignoriert werden. Überprüfen Sie auf der Passport-Website, ob Aktualisierungen zur SSL-Anmeldung verfügbar sind. Übergeben Sie –1, um anzuzeigen, dass Passport den Standardwert verwenden soll.

oExtraParams
Object

Direkt in den Authentifizierungsheader der Aufforderung einzufügende Name-Wert-Paare, insbesondere für Authentifizierungsinteraktionen, die Passport unterstützen. Übergeben Sie null, um anzuzeigen, dass Passport den Standardwert verwenden soll.

Gibt zurück

Int32

Ein ganzzahliger Ergebniscode.

Beispiele

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

Hinweise

Diese Klasse wurde veraltet und wird nicht mehr unterstützt. Microsoft Passport Network wurde durch Windows Live ID ersetzt.

Gilt für

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

Meldet den Benutzer an, indem entweder eine 302-Umleitungs-URL generiert oder ein Client-Authentifizierungsaustausch initiiert wird, der Passport unterstützt. Diese Klasse ist veraltet.

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

Parameter

szRetURL
String

Die URL, zu der der Anmeldeserver Benutzer nach abgeschlossener Anmeldung umleiten soll. Übergeben Sie null, um anzuzeigen, dass Passport den Standardwert verwenden soll.

iTimeWindow
Int32

Der Zeitwert in Sekunden. Übergeben Sie –1, um anzuzeigen, dass Passport den Standardwert verwenden soll.

fForceLogin
Int32

Gibt an, ob der Anmeldeserver den iTimeWindow-Parameter mit dem Zeitpunkt vergleichen soll, an dem sich der Benutzer zuletzt angemeldet hat, oder mit dem Zeitpunkt der letzten Aktualisierung des Tickets. Übergeben Sie –1, um anzuzeigen, dass Passport den Standardwert verwenden soll.

szCOBrandArgs
String

Eine Zeichenfolge, die Variablen angibt, die als Abfragezeichenfolgenvariablen an die URL der Cobranding-Vorlagenskriptseite des Teilnehmers angefügt werden sollen. Übergeben Sie null, um anzuzeigen, dass Passport den Standardwert verwenden soll.

iLangID
Int32

Ein Gebietsschemabezeichner (LCID, Locale Identifier), der die Sprache angibt, in der die Anmeldeseite angezeigt werden soll. Übergeben Sie –1, um anzuzeigen, dass Passport den Standardwert verwenden soll.

strNameSpace
String

Ein Domänennamespace, an den Benutzer ohne Passports zum Registrieren geleitet werden sollen. Der angegebene Namespace muss als "domain name"-Eintrag im CCD (Component Configuration Document) Partner.xml vorhanden sein. Der übliche Standardnamespace lautet "passport.com". Übergeben Sie null, um anzuzeigen, dass Passport den Standardwert verwenden soll.

iKPP
Int32

Übergeben Sie –1, um anzuzeigen, dass Passport den Standardwert verwenden soll. Dieser Parameter ist nur bei der Implementierung des Kids Passport-Dienstes relevant, derzeit kann der Kids Passport-Dienst die Verwendung dieser Methode jedoch nicht unterstützen.

iUseSecureAuth
Int32

SSL-Anmeldung ist als Option bei Anmeldeservern der aktuellen Version nicht verfügbar. Zu den Methoden des Passport-Managers gehören SSL-Anmeldeparameter, die für die Syntax erforderlich sein können, aber derzeit vom Server ignoriert werden. Überprüfen Sie auf der Passport-Website, ob Aktualisierungen zur SSL-Anmeldung verfügbar sind. Übergeben Sie –1, um anzuzeigen, dass Passport den Standardwert verwenden soll.

oExtraParams
Object

Direkt in den Authentifizierungsheader der Aufforderung einzufügende Name-Wert-Paare, insbesondere für Authentifizierungsinteraktionen, die Passport unterstützen. Übergeben Sie null, um anzuzeigen, dass Passport den Standardwert verwenden soll.

Gibt zurück

Int32

Ein ganzzahliger Ergebniscode.

Hinweise

Diese Klasse wurde veraltet und wird nicht mehr unterstützt. Microsoft Passport Network wurde durch Windows Live ID ersetzt.

Gilt für