PassportIdentity.LoginUser Yöntem

Başvuru

Tanım

Ad Alanı:: System.Web.Security

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

302 yeniden yönlendirme URL'si oluşturarak veya Passport kullanan bir istemci kimlik doğrulaması değişimi başlatarak kullanıcıyı günlüğe kaydeder. Bu sınıf kullanım dışı bırakıldı.

Aşırı Yüklemeler

LoginUser()	302 yeniden yönlendirme URL'si oluşturarak veya Passport kullanan istemci kimlik doğrulaması değişimini başlatarak kullanıcıyı günlüğe kaydeder. Bu sınıf kullanım dışı bırakıldı.
LoginUser(String)	302 yeniden yönlendirme URL'si oluşturarak veya Passport kullanan istemci kimlik doğrulaması değişimini başlatarak kullanıcıyı günlüğe kaydeder. Bu sınıf kullanım dışı bırakıldı.
LoginUser(String, Int32, Boolean, String, Int32, String, Int32, Boolean, Object)	302 yeniden yönlendirme URL'si oluşturarak veya Passport kullanan bir istemci kimlik doğrulaması değişimi başlatarak kullanıcıyı günlüğe kaydeder. Bu sınıf kullanım dışı bırakıldı.
LoginUser(String, Int32, Int32, String, Int32, String, Int32, Int32, Object)	302 yeniden yönlendirme URL'si oluşturarak veya Passport kullanan istemci kimlik doğrulaması değişimini başlatarak kullanıcıyı günlüğe kaydeder. Bu sınıf kullanım dışı bırakıldı.

Açıklamalar

Bu sınıf kullanım dışı bırakıldı ve artık desteklenmiyor. Microsoft Passport Network, Windows Live ID ile değiştirildi.

LoginUser()

302 yeniden yönlendirme URL'si oluşturarak veya Passport kullanan istemci kimlik doğrulaması değişimini başlatarak kullanıcıyı günlüğe kaydeder. Bu sınıf kullanım dışı bırakıldı.

public:
 int LoginUser();

public int LoginUser ();

member this.LoginUser : unit -> int

Public Function LoginUser () As Integer

Döndürülenler

Int32

Tamsayı sonuç kodu.

Açıklamalar

Bu sınıf kullanım dışı bırakıldı ve artık desteklenmiyor. Microsoft Passport Network, Windows Live ID ile değiştirildi.

Şunlara uygulanır

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

Parametreler

strReturnUrl: String

Oturum açma tamamlandıktan sonra Oturum açma sunucusunun kullanıcıları yeniden yönlendirmesi gereken URL. Passport'un varsayılan değeri kullanması gerektiğini belirtmek için geçirin null .

Döndürülenler

Int32

Tamsayı sonuç kodu.

Açıklamalar

Bu sınıf kullanım dışı bırakıldı ve artık desteklenmiyor. Microsoft Passport Network, Windows Live ID ile değiştirildi.

Şunlara uygulanır

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

Parametreler

szRetURL: String

iTimeWindow: Int32

Saniye olarak zaman değeri. Passport'un varsayılan değeri kullanması gerektiğini belirtmek için -1'i geçirin.

fForceLogin: Boolean

true oturum açma sunucusunun, kullanıcının son oturum açma tarihinden bu yana geçen süreyle parametresini karşılaştırmasını iTimeWindow sağlamak; false Oturum Açma sunucusunun Anahtar'ın son yenilenme zamanıyla karşılaştırmasını iTimeWindow sağlamak için. Passport'un varsayılan değeri kullanması gerektiğini belirtmek için -1'i geçirin.

szCOBrandArgs: String

Katılımcının Cobranding Şablonu betik sayfasının URL'sine sorgu dizesi değişkenleri olarak eklenecek değişkenleri belirten bir dize. Passport'un varsayılan değeri kullanması gerektiğini belirtmek için geçirin null .

iLangID: Int32

Oturum Açma sayfasının görüntülenmesi gereken dili belirten bir yerel ayar tanımlayıcısı (LCID). Passport'un varsayılan değeri kullanması gerektiğini belirtmek için -1'i geçirin.

strNameSpace: String

Passport'ları olmayan kullanıcıları kaydolmaya yönlendirmek istediğiniz etki alanı adı alanı. Belirtilen ad alanı, Partner.xml Bileşen Yapılandırma Belgesi'nde (CCD) "etki alanı adı" girdisi olarak görünmelidir. Tipik varsayılan ad alanı "passport.com"dır. Passport'un varsayılan değeri kullanması gerektiğini belirtmek için geçirin null .

iKPP: Int32

Passport'un varsayılan değeri kullanması gerektiğini belirtmek için -1'i geçirin. Bu parametre yalnızca Kids Passport hizmeti uygulanırken geçerlidir; ancak, Kids Passport hizmeti şu anda bu yöntemin kullanımını destekleyemez.

fUseSecureAuth: Boolean

SSL oturum açma, geçerli sürümdeki Oturum açma sunucularında bir seçenek olarak kullanılamaz. Passport Manager yöntemleri SSL oturum açma parametrelerini içerir ve söz dizimi için gerekli olabilir, ancak şu anda sunucuda yok sayılırlar. SSL oturum açma durumuyla ilgili güncelleştirmeler için Passport Web sitesini denetleyin. Passport'un varsayılan değeri kullanması gerektiğini belirtmek için -1'i geçirin.

oExtraParams: Object

Özellikle Passport kullanan kimlik doğrulaması etkileşimi için doğrudan sınama kimlik doğrulaması üst bilgisine eklenecek ad-değer çiftleri. Passport'un varsayılan değeri kullanması gerektiğini belirtmek için geçirin null .

Döndürülenler

Int32

Tamsayı sonuç kodu.

Örnekler

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

Açıklamalar

Bu sınıf kullanım dışı bırakıldı ve artık desteklenmiyor. Microsoft Passport Network, Windows Live ID ile değiştirildi.

Şunlara uygulanır

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

Parametreler

szRetURL: String

iTimeWindow: Int32

Saniye olarak zaman değeri. Passport'un varsayılan değeri kullanması gerektiğini belirtmek için -1'i geçirin.

fForceLogin: Int32

Oturum açma sunucusunun parametreyi iTimeWindow kullanıcının son oturum açma tarihinden bu yana geçen süreyle mi yoksa Anahtar'ın son yenilenme zamanıyla mı karşılaştırması gerektiğini gösterir. Passport'un varsayılan değeri kullanması gerektiğini belirtmek için -1'i geçirin.

szCOBrandArgs: String

iLangID: Int32

Oturum Açma sayfasının görüntülenmesi gereken dili belirten bir yerel ayar tanımlayıcısı (LCID). Passport'un varsayılan değeri kullanması gerektiğini belirtmek için -1'i geçirin.

strNameSpace: String

iKPP: Int32

iUseSecureAuth: Int32

oExtraParams: Object

Döndürülenler

Int32

Tamsayı sonuç kodu.

Açıklamalar

Bu sınıf kullanım dışı bırakıldı ve artık desteklenmiyor. Microsoft Passport Network, Windows Live ID ile değiştirildi.

Şunlara uygulanır

Aracılığıyla paylaş

PassportIdentity.LoginUser Yöntem

Tanım

Aşırı Yüklemeler

Açıklamalar

LoginUser()

Döndürülenler

Açıklamalar

Şunlara uygulanır

LoginUser(String)

Parametreler

Döndürülenler

Açıklamalar

Şunlara uygulanır

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

Parametreler

Döndürülenler

Örnekler

Açıklamalar

Şunlara uygulanır

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

Parametreler

Döndürülenler

Açıklamalar

Şunlara uygulanır

Geri Bildirim

Ek kaynaklar