SecurityTokenServiceClient.RenewSecurityTokenResponse Method

Article
09/15/2006

Makes a request to a security token service to renew a security token using the response from a previous request.

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

Usage

'Usage
Dim request As RequestSecurityTokenResponse
Dim returnValue As RequestSecurityTokenResponse
Dim securityTokenServiceClient1 As SecurityTokenServiceClient
returnValue = securityTokenServiceClient1.RenewSecurityTokenResponse(request)

Syntax

'Declaration
Public Overridable Function RenewSecurityTokenResponse( _
    ByVal request As RequestSecurityTokenResponse _
) As RequestSecurityTokenResponse

public virtual RequestSecurityTokenResponse RenewSecurityTokenResponse(
    RequestSecurityTokenResponse request
);

public: RequestSecurityTokenResponse^ RenewSecurityTokenResponse(
    RequestSecurityTokenResponse^ request
);

public RequestSecurityTokenResponse RenewSecurityTokenResponse(
    RequestSecurityTokenResponse request
);

public function RenewSecurityTokenResponse(
     request : RequestSecurityTokenResponse
) : RequestSecurityTokenResponse;

Parameters

request
A RequestSecurityTokenResponse that contains the details of the response from a previous request.

Return Value

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

Remarks

The RenewSecurityTokenResponse method calls the RequestSecurityToken method, which calls the EnforceRequestPolicy method before making the security token request. When the response is received for the security token request, the VerifyResponsePolicy and SetupIssuedToken methods are called.

The SecurityContextTokenService security token service does not support this type of request and throws a TrustFault exception if one is received.

Use this IssueSecurityTokenResponse overload when multiple messages must be exchanged between the SOAP sender and the security token service. Multiple messages may be required if a security token service uses a challenge/response mechanism to authenticate the SOAP message sender.

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