UsernameForCertificateAssertion.CorrelationState Class

  • Article

This class is used to transfer state information between the input filters (when a message is being processed) and the output filters (when the message is being sent).

Namespace: Microsoft.Web.Services3.Design
Assembly: Microsoft.Web.Services3 (in microsoft.web.services3.dll)

Usage

'Usage
Dim usernameForCertificateAssertion_CorrelationState1 As New UsernameForCertificateAssertion.CorrelationState()

Syntax

'Declaration
Protected Class UsernameForCertificateAssertion.CorrelationState
    Inherits SerializableTokenWrapper(Of EncryptedKeyToken)

protected class UsernameForCertificateAssertion.CorrelationState : SerializableTokenWrapper<EncryptedKeyToken>

ref class UsernameForCertificateAssertion::CorrelationState : SerializableTokenWrapper<EncryptedKeyToken^>

protected class UsernameForCertificateAssertion.CorrelationState extends SerializableTokenWrapper<EncryptedKeyToken>

JScript does not support Generics.

Remarks

All assertions store data in a CorrelationState object, and this assertion stores the EncryptedKeyToken used to secure the message in this state. On the client, the UsernameForCertificateAssertion.ClientOutputFilter stores the EncryptedKeyToken in an instance of the UsernameForCertificateAssertion.CorrelationState class, that is then stored in the Web Service Client's OperationState property. When a response is received, the UsernameForCertificateAssertion.ClientInputFilter object processes this message to make sure that the incoming response was secured with the same EncryptedKeyToken as the request. To ensure this, it compares the EncryptedKeyToken that secured the incoming response with the EncryptedKeyToken that was stored in the CorrelationState, within the OperationState.

This class inherits from a SerializableTokenWrapper which means that this class can be serialized and deserialized to and from XML. Serializing this class to XML also serializes the EncryptedKeyToken that is configured within this class.

Inheritance Hierarchy

System.Object
   Microsoft.Web.Services3.Security.SerializableTokenWrapper
    Microsoft.Web.Services3.Design.UsernameForCertificateAssertion.CorrelationState

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 2000, Windows 2000 Server, Windows 2000 Advanced Server

Target Platforms

See Also

Reference

UsernameForCertificateAssertion.CorrelationState Members
Microsoft.Web.Services3.Design Namespace