This documentation is archived and is not being maintained.

IInteractiveChannelInitializer.BeginDisplayInitializationUI Method

An asynchronous call to begin using a user interface to obtain credential information.

Namespace:  System.ServiceModel.Dispatcher
Assembly:  System.ServiceModel (in System.ServiceModel.dll)

IAsyncResult BeginDisplayInitializationUI(
	IClientChannel channel,
	AsyncCallback callback,
	Object state
)

Parameters

channel
Type: System.ServiceModel.IClientChannel

The client channel.

callback
Type: System.AsyncCallback

The callback object.

state
Type: System.Object

Any state data.

Return Value

Type: System.IAsyncResult
The System.IAsyncResult to use to call back when processing has completed.

To implement IInteractiveChannelInitializer, perform the following steps in IInteractiveChannelInitializer.BeginDisplayInitializationUI:

  1. Prompt the user in what way you see fit and obtain an appropriate System.Net.NetworkCredential.

  2. Add a custom channel parameter object to the collection returned by the IChannel.GetProperty<T> method on the IClientChannel object with a type parameter of System.ServiceModel.Channels.ChannelParameterCollection. This channel parameter object is used by the custom System.ServiceModel.ClientCredentialsSecurityTokenManager to establish the security tokens for the channel.

  3. Return.

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0
Show: