ContextFactory.CreateQueue Method (String, String)

Solclient

previous page next page

Solclient

ContextFactoryCreateQueue Method (String, String)

version: 7.2.1.27

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.

Namespace: SolaceSystems.Solclient.Messaging
Assembly: SolaceSystems.Solclient.Messaging (in SolaceSystems.Solclient.Messaging.dll) Version: 7.2.1.27 (7.2.1.27)

Syntax

C++

Copy

[ObsoleteAttribute("Use CreateQueue(string) instead", false)]
public IQueue CreateQueue(
	string name,
	string virtualRouterName
)

<ObsoleteAttribute("Use CreateQueue(string) instead", false)>
Public Function CreateQueue ( 
	name As String,
	virtualRouterName As String
) As IQueue

public:
[ObsoleteAttribute(L"Use CreateQueue(string) instead", false)]
IQueue^ CreateQueue(
	String^ name, 
	String^ virtualRouterName
)

Parameters

name: Type: SystemString
the local queue name
virtualRouterName: Type: SystemString
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

Type: IQueue
A durable queue instance

Exceptions

Exception	Condition
ArgumentNullException
OperationErrorException	Thrown when unable to create the queue

Reference

ContextFactory Class

CreateQueue Overload

SolaceSystems.Solclient.Messaging Namespace

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to use and copy the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

UNLESS STATED ELSEWHERE BETWEEN YOU AND SOLACE SYSTEMS, INC., THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Send comments on this topic to [email protected]

previous page start next page