10.27.03

ContextFactoryCreateQueue(String, String) Method

Note: This API is now obsolete.

Note: This method is obsolete, and its usage with appliances running SolOS Version 5.4 and greater is strongly discouraged. Applications should use CreateQueue(String) instead.

Creates a representation of a durable/non-temporary queue in the API, given its name and the Virtual Router Name of the hosting appliance.

Before creating a IFlow instance to a durable queue on the appliance, the queue must be first provisioned. Applications can provision durable/non-temporary queues using Provision(IEndpoint, EndpointProperties, Int32, Object).

Applications can send or receive Guaranteed messages from a Queue, messages received on a Queue have a single consumer. Multiple subscribers can listen for messages on the same Queue, but once any subscriber retrieves a particular message from the Queue and acknowledge it, that message is consumed and is no longer available to other potential subscribers. To consume messages from a Queue, client applications must create a Flow using CreateFlow(...) on ISession passing in the corresponding IQueue instance.

Definition

Namespace: SolaceSystems.Solclient.Messaging
Assembly: SolaceSystems.Solclient.Messaging (in SolaceSystems.Solclient.Messaging.dll) Version: 10.27.0
C#
[ObsoleteAttribute("Use CreateQueue(string) instead", false)]
public IQueue CreateQueue(
	string name,
	string virtualRouterName
)

Parameters

name  String
the local queue name
virtualRouterName  String
The network virtual router name of the appliance configured with the Queue. You must get this string from your network administrator or query the session property VirtualRouterName.

Return Value

IQueue
A durable queue instance

Exceptions

ArgumentNullException
OperationErrorException Thrown when unable to create the queue

See Also