SecurityTokenService.RenewSecurityTokenRequest Method (RequestSecurityToken)

Article
09/15/2006

Handles an incoming request to renew a security token in the form of a RequestSecurityToken.

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

Usage

'Usage
Dim request As RequestSecurityToken
Dim returnValue As RequestSecurityTokenResponse
Dim securityTokenService1 As SecurityTokenService
returnValue = securityTokenService1.RenewSecurityTokenRequest(request)

Syntax

'Declaration
Overloads Public Overridable Function RenewSecurityTokenRequest( _
    ByVal request As RequestSecurityToken _
) As RequestSecurityTokenResponse

public virtual RequestSecurityTokenResponse RenewSecurityTokenRequest(
    RequestSecurityToken request
);

public: RequestSecurityTokenResponse^ RenewSecurityTokenRequest(
    RequestSecurityToken^ request
);

public RequestSecurityTokenResponse RenewSecurityTokenRequest(
    RequestSecurityToken request
);

public function RenewSecurityTokenRequest(
     request : RequestSecurityToken
) : RequestSecurityTokenResponse;

Parameters

request
A RequestSecurityToken that contains the details of the request.

Return Value

TrustFault

The default implementation of this method is used.

A RequestSecurityTokenResponse that contains the details of the response to the request.

Exceptions

Exception type	Condition
TrustFault	request is null. -or- request is not a request to renew a security token.

TrustFault

request is null.

-or-

request is not a request to renew a security token.

Remarks

The default implementation of this method always throws a TrustFault exception.

The RenewSecurityTokenRequest method calls the VerifyRequestPolicy, RenewSecurityToken, EnforceResponsePolicy, and SetupIssuedToken methods.

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

Share via