MsmqTransportBindingElement.BuildChannelFactory<TChannel> Method


Builds a channel factory using the context provided.

generic <typename TChannel>
 override System::ServiceModel::Channels::IChannelFactory<TChannel> ^ BuildChannelFactory(System::ServiceModel::Channels::BindingContext ^ context);
public override System.ServiceModel.Channels.IChannelFactory<TChannel> BuildChannelFactory<TChannel> (System.ServiceModel.Channels.BindingContext context);
override this.BuildChannelFactory : System.ServiceModel.Channels.BindingContext -> System.ServiceModel.Channels.IChannelFactory<'Channel>
Public Overrides Function BuildChannelFactory(Of TChannel) (context As BindingContext) As IChannelFactory(Of TChannel)

Type Parameters


A IOutputSessionChannel or a IOutputChannel class.



The BindingContext with which to build the channel factory.


A Message Queuing (MSMQ) channel factory that can be used to create channels to send messages to existing Message Queuing applications.


The context value is null.

The TChannel is not IOutputChannel or IOutputSessionChannel.

ExactlyOnce is true and Durable is false.


UseActiveDirectory is true and QueueTransferProtocol is not Native.


CustomDeadLetterQueue is not null and DeadLetterQueue is not Custom.


DeadLetterQueue is set to Custom on Windows 2003/XP.


ExactlyOnce is false and DeadLetterQueue is Custom.


CustomDeadLetterQueue is set and either there is no write permission to write to the queue, or the queue does not exist.


CustomDeadLetterQueue is non-transactional.


MsmqTransportSecurity.MsmqAuthenticationMode is set to WindowsDomain and MSMQ is installed without ActiveDirectory integration.


MsmqTransportSecurity.MsmqAuthenticationMode is None and MsmqTransportSecurity.MsmqProtectionLevel is not None.


MsmqTransportSecurity.MsmqAuthenticationMode is Certificate or WindowsDomain and MsmqTransportSecurity.MsmqProtectionLevel is None.


MsmqTransportSecurity.MsmqProtectionLevel is EncryptAndSign and UseActiveDirectory is false.




A channel factory is created and initialized using the properties that have been set in the binding element. The initialized channel factory is then used to create output channels that can be used to send messages to a message queue.

Applies to