EnablePublishConfirms Method

Enables publish confirmations mode for a channel.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int EnablePublishConfirms(const char* lpszChannelName, int bNoWait);

Unicode (Windows)
INT EnablePublishConfirms(LPCWSTR lpszChannelName, BOOL bNoWait);

- (void)enablePublishConfirms:(NSString*)channelName :(BOOL)noWait;

#define MID_AMQPCLASSIC_ENABLEPUBLISHCONFIRMS 16

IPWORKSIOT_EXTERNAL int IPWORKSIOT_CALL IPWorksIoT_AMQPClassic_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

This method enables publish confirmations mode for the channel with the given ChannelName.

While a channel is in publish confirmations mode, the server will acknowledge each message published by the class. The class will wait to fire the MessageOut event until it receives this acknowledgement. (Note that this mode is only available when the RabbitMQCompatible configuration setting is enabled.)

Note that a channel will stay in publish confirmations mode, once enabled, until it is deleted.

The NoWait parameter, if True, will cause the server to execute the request asynchronously. For asynchronous request handling, the server only sends back a response in case of an error.

An exception is thrown if the RabbitMQCompatible configuration setting is currently False, if no channel with the given ChannelName exists, or if EnableTransactionMode has been called for the specified channel previously.

Error Handling (C++)

This method returns a result code; 0 indicates success, while a non-zero error code indicates that this method encountered an error during its execution. If an error occurs, the GetLastError() method can be called to retrieve the associated error message. (Note: This method's result code can also be obtained by calling the GetLastErrorCode() method after it returns.)