Skip Headers
Oracle® Objects for OLE C++ Class Library Developer's Guide
10g Release 2 (10.2)

Part Number B14308-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

AQAgent Method

Applies To

OAQMsg

Description

Creates an instance of the OAQAgent for the specified consumer and adds it to the OAQAgents list of the message.

Usage

OAQAgent* AQAgent(const char *name, const char *addr) const throw(OException)

Arguments

Arguments
Description
name
A string up to 30 bytes representing the name of the consumer of the message.
addr
An optional 128 byte string representing the protocol specific address of recipient, such as schema.]queue[@dblink].

Remarks

The OAQAgent object represents a message recipient and is only valid for queues which allow multiple consumers. Queue subscribers are recipients by default. Use this to override the default consumers.

The maximum number of agents that a message can support is 10. The AQAgent method returns an instance of an OAQAgent.

Note: The address is not supported in this release, but is provided for future enhancements.