SecurityTokenManager.GetTokenFromSecurityTokenAssertion Method

Article
09/15/2006
2 minutes to read

Loads a security token referenced in a policy assertion into a SecurityToken when the security token type is unknown.

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

Usage

'Usage
Dim sta As ISecurityTokenAssertion
Dim returnValue As SecurityToken
returnValue = SecurityTokenManager.GetTokenFromSecurityTokenAssertion(sta)

Syntax

'Declaration
Public Shared Function GetTokenFromSecurityTokenAssertion( _
    ByVal sta As ISecurityTokenAssertion _
) As SecurityToken

public static SecurityToken GetTokenFromSecurityTokenAssertion(
    ISecurityTokenAssertion sta
);

public: static SecurityToken^ GetTokenFromSecurityTokenAssertion(
    ISecurityTokenAssertion^ sta
);

public static SecurityToken GetTokenFromSecurityTokenAssertion(
    ISecurityTokenAssertion sta
);

public static function GetTokenFromSecurityTokenAssertion(
     sta : ISecurityTokenAssertion
) : SecurityToken;

Parameters

sta
An ISecurityTokenAssertion from a policy assertion that references a SecurityToken security token.

Return Value

The SecurityToken that is referenced in the sta parameter.

Exceptions

Exception type	Condition
SecurityFault	no security token managers could create a SecurityToken instanced given the sta parameter.

Remarks

When the security token type that is referenced in a policy assertion has not been determined, use the GetTokenFromSecurityTokenAssertion method. The GetTokenFromSecurityTokenAssertion method determines the security token type referenced in the policy assertion. If a token type is not associated with the policy assertion, an SecurityFault is thrown.

When the security token type referenced in the policy assertion is known, call the LoadTokenFromSecurityTokenAssertion method of the security tokens manager for the security token type.

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