SecurityContextTokenServiceClient.BeginIssueSecurityContextTokenAuthenticated Method (SecurityToken, SecurityToken, AppliesTo, AsyncCallback, Object)

Article
09/15/2006
2 minutes to read

Begins a digitally signed asynchronous request for a SecurityContextToken security token from a security token service. If the request is successful, an entropy value is returned in an <Entropy> element.

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

Usage

'Usage
Dim baseToken As SecurityToken
Dim issuerToken As SecurityToken
Dim appliesTo As AppliesTo
Dim callback As AsyncCallback
Dim state As Object
Dim returnValue As IAsyncResult
Dim securityContextTokenServiceClient1 As SecurityContextTokenServiceClient
returnValue = securityContextTokenServiceClient1.BeginIssueSecurityContextTokenAuthenticated(baseToken, issuerToken, appliesTo, callback, state)

Syntax

'Declaration
Overloads Public Overridable Function BeginIssueSecurityContextTokenAuthenticated( _
    ByVal baseToken As SecurityToken, _
    ByVal issuerToken As SecurityToken, _
    ByVal appliesTo As AppliesTo, _
    ByVal callback As AsyncCallback, _
    ByVal state As Object _
) As IAsyncResult

public virtual IAsyncResult BeginIssueSecurityContextTokenAuthenticated(
    SecurityToken baseToken, 
    SecurityToken issuerToken, 
    AppliesTo appliesTo, 
    AsyncCallback callback, 
    object state
);

public: IAsyncResult^ BeginIssueSecurityContextTokenAuthenticated(
    SecurityToken^ baseToken, 
    SecurityToken^ issuerToken, 
    AppliesTo^ appliesTo, 
    AsyncCallback^ callback, 
    Object^ state
);

public IAsyncResult BeginIssueSecurityContextTokenAuthenticated(
    SecurityToken baseToken, 
    SecurityToken issuerToken, 
    AppliesTo appliesTo, 
    AsyncCallback callback, 
    System.Object state
);

public function BeginIssueSecurityContextTokenAuthenticated(
     baseToken : SecurityToken, 
     issuerToken : SecurityToken, 
     appliesTo : AppliesTo, 
     callback : AsyncCallback, 
     state : Object
) : IAsyncResult;

Parameters

baseToken
The SecurityToken that signs the security token request.

issuerToken
The SecurityToken that encrypts the SOAP message sender's entropy value.

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

callback
An System.AsyncCallback that is called when the asynchronous operation is completed. If callback is null, the delegate is not called.

state
An object that contains state information for this request.

Return Value

The SecurityContextToken issued by the security token service.

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

To request a SecurityContextToken security token, call one of the IssueSecurityContextTokenAuthenticated or IssueSecurityContextToken overloads.

When the issuerToken parameter is null, the RequestSecurityContextToken method expects the SecurityContextToken to be returned within a <ProofToken> element.

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