X509SecurityTokenManager.LoadTokenFromSecurityTokenAssertion Method

Article
09/15/2006
2 minutes to read

Loads an X.509 security token referenced in a policy assertion into a X509SecurityToken.

Namespace: Microsoft.Web.Services2.Security.Tokens
Assembly: Microsoft.Web.Services2 (in microsoft.web.services2.dll)

Usage

'Usage
Dim ista As ISecurityTokenAssertion
Dim returnValue As SecurityToken
Dim x509SecurityTokenManager1 As X509SecurityTokenManager
returnValue = x509SecurityTokenManager1.LoadTokenFromSecurityTokenAssertion(ista)

Syntax

'Declaration
Public Overrides Function LoadTokenFromSecurityTokenAssertion( _
    ByVal ista As ISecurityTokenAssertion _
) As SecurityToken

public override SecurityToken LoadTokenFromSecurityTokenAssertion(
    ISecurityTokenAssertion ista
);

public: virtual SecurityToken^ LoadTokenFromSecurityTokenAssertion(
    ISecurityTokenAssertion^ ista
);

public SecurityToken LoadTokenFromSecurityTokenAssertion(
    ISecurityTokenAssertion ista
);

public override function LoadTokenFromSecurityTokenAssertion(
     ista : ISecurityTokenAssertion
) : SecurityToken;

Parameters

ista
An ISecurityTokenAssertion from a policy assertion that references an X509SecurityToken security token.

Return Value

The X509SecurityToken that is referenced in ista, or null if the operation fails.

Remarks

When the ista parameter is null or does not reference an X509SecurityToken, null is returned.

Use the LoadTokenFromSecurityTokenAssertion method to parse the XML elements of policy assertions that reference X509SecurityToken security tokens. That method returns an ISecurityTokenAssertion that can be passed to the LoadTokenFromSecurityTokenAssertion method to create an X509SecurityToken instance.

Notes to Inheritors: If an exception is thrown by this method, processing for the current SOAP message will fail.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

Windows XP Home Edition, Windows XP Professional, Windows Server 2003, Windows Longhorn, and Windows 2000

Target Platforms

Windows 2000, Windows 2000 Server, Windows 2000 Advanced Server, Windows XP Home Edition, Windows XP Professional, Windows Server 2003, Windows Longhorn, Pocket PC, Windows CE, Smart Phone