SecurityContextTokenServiceClient.IssueSecurityContextToken Method (AppliesTo)

Article
09/15/2006

Makes an unsigned request for a SecurityContextToken security token from a security token service for use with a specific Web service. The security token is returned in a <ProofToken> element.

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

Usage

'Usage
Dim appliesTo As AppliesTo
Dim returnValue As SecurityContextToken
Dim securityContextTokenServiceClient1 As SecurityContextTokenServiceClient
returnValue = securityContextTokenServiceClient1.IssueSecurityContextToken(appliesTo)

Syntax

'Declaration
Overloads Public Overridable Function IssueSecurityContextToken( _
    ByVal appliesTo As AppliesTo _
) As SecurityContextToken

public virtual SecurityContextToken IssueSecurityContextToken(
    AppliesTo appliesTo
);

public: SecurityContextToken^ IssueSecurityContextToken(
    AppliesTo^ appliesTo
);

public SecurityContextToken IssueSecurityContextToken(
    AppliesTo appliesTo
);

public function IssueSecurityContextToken(
     appliesTo : AppliesTo
) : SecurityContextToken;

Parameters

appliesTo
An AppliesTo that specifies the Web service the requested security token will be used to communicate with.

Return Value

The SecurityContextToken issued by the security token service.

Exceptions

Exception type	Condition
System.ArgumentNullException	appliesTo is null.
TrustFault	The security token service did not return a response. -or- The response from the security token service is not signed. -or- The response contains an <Entropy> element.

System.ArgumentNullException

appliesTo is null.

TrustFault

The security token service did not return a response.

-or-

The response from the security token service is not signed.

-or-

The response contains an <Entropy> element.

Remarks

The SecurityContextToken issued by the security token service is used to exchange SOAP messages with the Web service that is specified by the appliesTo parameter.

Because this overload does not sign the security token request, an exception is thrown if this request is sent to the SecurityContextTokenService security token service.

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