CreateChannel Method

Creates a new channel.

Syntax

ANSI (Cross Platform)
int CreateChannel(const char* lpszChannelName);

Unicode (Windows)
INT CreateChannel(LPCWSTR lpszChannelName);

- (void)createChannel:(NSString*)channelName;

#define MID_AMQPCLASSIC_CREATECHANNEL 9

IPWORKSMQ_EXTERNAL int IPWORKSMQ_CALL IPWorksMQ_AMQPClassic_Do(void *lpObj, int methid, int cparam, void *param[], int cbparam[], int64 *lpllVal);

Remarks

This method creates a new channel with the name ChannelName and adds it to the Channel* properties. If a channel with the given ChannelName already exists, an error will be thrown.

Connecting and Creating a Channel

// The examples in this documentation use a RabbitMQ server, which requires SASL Plain auth.
amqpc1.AuthScheme = AmqpclassicAuthSchemes.smSASLPlain;
amqpc1.User = "guest";
amqpc1.Password = "guest";
amqpc1.SSLEnabled = true;
amqpc1.Connect("amqpclassic.test-server.com", 5671);
amqpc1.CreateChannel("channel");

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.)

IPWorks MQ 2020 C++ Edition Website Download Support Questions / Feedback?
IPWorks MQ 2020 C++ Edition Introduction Licensing Instructions AmazonSQS Class Introduction Properties AccessKey AttributesCount AttributesName AttributesValue FirewallAutoDetect FirewallType FirewallHost FirewallPassword FirewallPort FirewallUser LocalHost MaxMessages MessagesCount MessagesBody MessagesId MessagesMD5 MessagesReceiptHandle OtherHeaders ProxyAuthScheme ProxyAutoDetect ProxyPassword ProxyPort ProxyServer ProxySSL ProxyUser QueuePrefix QueuesCount QueuesId QueuesUrl Referer SecretKey SSLAcceptServerCertEncoded SSLCertEncoded SSLCertStore SSLCertStorePassword SSLCertStoreType SSLCertSubject SSLServerCertEncoded StatusLine Timeout UseSSL VisibilityTimeout Methods AddPermission ChangeMessageVisibility Config CreateMessage CreateQueue DeleteMessage DeleteQueue DoEvents GetQueueAttributes GetXValue Interrupt ListMessages ListQueues RemovePermission Reset ResetHeaders SendCustomRequest SetQueueAttribute Events Connected Disconnected EndTransfer Error Header Message Queue SSLServerAuthentication SSLStatus StartTransfer Status Transfer Configuration Error Codes AMQP Class Introduction Properties AuthScheme Connected ContainerId FetchTimeout FirewallAutoDetect FirewallType FirewallHost FirewallPassword FirewallPort FirewallUser IdleTimeout IncomingMessageCount IncomingMessageAbsoluteExpiryTime IncomingMessageContentEncoding IncomingMessageContentType IncomingMessageCorrelationId IncomingMessageCreationTime IncomingMessageDeliveryCount IncomingMessageDurable IncomingMessageFirstAcquirer IncomingMessageGroupId IncomingMessageGroupSequence IncomingMessageLinkName IncomingMessageId IncomingMessagePriority IncomingMessageReplyTo IncomingMessageReplyToGroupId IncomingMessageSettled IncomingMessageSubject IncomingMessageTo IncomingMessageTTL IncomingMessageUserId IncomingMessageValue IncomingMessageValueType LinkCount LinkAvailable LinkChannelName LinkCredit LinkDeliveryCount LinkName LinkReadyToSend LinkReceiveMode LinkRole LocalHost LocalPort MessageAbsoluteExpiryTime MessageContentEncoding MessageContentType MessageCorrelationId MessageCreationTime MessageDeliveryCount MessageDurable MessageFirstAcquirer MessageGroupId MessageGroupSequence MessageLinkName MessageId MessagePriority MessageReplyTo MessageReplyToGroupId MessageSettled MessageSubject MessageTo MessageTTL MessageUserId MessageValue MessageValueType OutgoingMessageCount OutgoingMessageAbsoluteExpiryTime OutgoingMessageContentEncoding OutgoingMessageContentType OutgoingMessageCorrelationId OutgoingMessageCreationTime OutgoingMessageDeliveryCount OutgoingMessageDurable OutgoingMessageFirstAcquirer OutgoingMessageGroupId OutgoingMessageGroupSequence OutgoingMessageLinkName OutgoingMessageId OutgoingMessagePriority OutgoingMessageReplyTo OutgoingMessageReplyToGroupId OutgoingMessageSettled OutgoingMessageSubject OutgoingMessageTo OutgoingMessageTTL OutgoingMessageUserId OutgoingMessageValue OutgoingMessageValueType Password ReadyToSend ReceivedMessageAbsoluteExpiryTime ReceivedMessageContentEncoding ReceivedMessageContentType ReceivedMessageCorrelationId ReceivedMessageCreationTime ReceivedMessageDeliveryCount ReceivedMessageDurable ReceivedMessageFirstAcquirer ReceivedMessageGroupId ReceivedMessageGroupSequence ReceivedMessageLinkName ReceivedMessageId ReceivedMessagePriority ReceivedMessageReplyTo ReceivedMessageReplyToGroupId ReceivedMessageSettled ReceivedMessageSubject ReceivedMessageTo ReceivedMessageTTL ReceivedMessageUserId ReceivedMessageValue ReceivedMessageValueType ReceiveMode RemoteHost RemotePort SessionCount SessionIncomingWindow SessionName SessionOutgoingWindow SSLAcceptServerCertEncoded SSLCertEncoded SSLCertStore SSLCertStorePassword SSLCertStoreType SSLCertSubject SSLEnabled SSLServerCertEncoded Timeout User Methods CloseLink CloseSession Config Connect CreateReceiverLink CreateSenderLink CreateSession Disconnect DoEvents FetchMessage Interrupt Reset ResetMessage SendMessage Events Connected ConnectionStatus Disconnected Error LinkReadyToSend Log MessageIn MessageOut MessageOutcome SSLServerAuthentication SSLStatus Configuration Error Codes AMQPClassic Class Introduction Properties ArgumentCount ArgumentName ArgumentValue ArgumentValueType AuthScheme ChannelCount ChannelAccept ChannelMode ChannelName ChannelReadyToSend ClientPropertyCount ClientPropertyName ClientPropertyValue ClientPropertyValueType Connected FirewallAutoDetect FirewallType FirewallHost FirewallPassword FirewallPort FirewallUser Heartbeat IncomingMessageCount IncomingMessageAppId IncomingMessageBody IncomingMessageChannelName IncomingMessageContentEncoding IncomingMessageContentType IncomingMessageCorrelationId IncomingMessageDeliveryMode IncomingMessageExpiration IncomingMessageHeaders IncomingMessageId IncomingMessagePriority IncomingMessageReplyTo IncomingMessageTimestamp IncomingMessageType IncomingMessageUserId LocalHost LocalPort MessageAppId MessageBody MessageChannelName MessageContentEncoding MessageContentType MessageCorrelationId MessageDeliveryMode MessageExpiration MessageHeaders MessageId MessagePriority MessageReplyTo MessageTimestamp MessageType MessageUserId OutgoingMessageCount OutgoingMessageAppId OutgoingMessageBody OutgoingMessageChannelName OutgoingMessageContentEncoding OutgoingMessageContentType OutgoingMessageCorrelationId OutgoingMessageDeliveryMode OutgoingMessageExpiration OutgoingMessageHeaders OutgoingMessageId OutgoingMessagePriority OutgoingMessageReplyTo OutgoingMessageTimestamp OutgoingMessageType OutgoingMessageUserId Password QueueMessageCount ReceivedMessageAppId ReceivedMessageBody ReceivedMessageChannelName ReceivedMessageContentEncoding ReceivedMessageContentType ReceivedMessageCorrelationId ReceivedMessageDeliveryMode ReceivedMessageExpiration ReceivedMessageHeaders ReceivedMessageId ReceivedMessagePriority ReceivedMessageReplyTo ReceivedMessageTimestamp ReceivedMessageType ReceivedMessageUserId RemoteHost RemotePort ServerPropertyCount ServerPropertyName ServerPropertyValue ServerPropertyValueType SSLAcceptServerCertEncoded SSLCertEncoded SSLCertStore SSLCertStorePassword SSLCertStoreType SSLCertSubject SSLEnabled SSLServerCertEncoded Timeout User VirtualHost Methods BindQueue CancelConsume CloseChannel CommitTransaction Config Connect Consume CreateChannel DeclareExchange DeclareQueue DeleteExchange DeleteQueue Disconnect DoEvents EnablePublishConfirms EnableTransactionMode FetchMessage Interrupt PublishMessage PurgeQueue Recover Reset ResetMessage RollbackTransaction SetChannelAccept SetQoS UnbindQueue Events ChannelReadyToSend Connected ConnectionStatus Disconnected Error Log MessageIn MessageOut MessageReturned SSLServerAuthentication SSLStatus Configuration Error Codes AzureRelayProxy Class Introduction Properties AccessKey AccessKeyName ConnectionBacklog AzureRelayProxyConnectionCount AzureRelayProxyConnectionConnected AzureRelayProxyConnectionConnectionId AzureRelayProxyConnectionIdleTimeout AzureRelayProxyConnectionLocalAddress AzureRelayProxyConnectionRemoteHost AzureRelayProxyConnectionRemotePort AzureRelayProxyConnectionTimeout AzureRelayProxyConnectionUserData DefaultIdleTimeout DefaultTimeout HybridConnection KeepAlive Linger Listening LocalHost LocalPort NamespaceAddress SSLAuthenticateClients SSLCertEncoded SSLCertStore SSLCertStorePassword SSLCertStoreType SSLCertSubject SSLEnabled SSLStartMode Methods Config Disconnect DoEvents Reset Shutdown Events Connected ConnectionRequest Disconnected Error Log SSLClientAuthentication SSLConnectionRequest SSLStatus Configuration Error Codes AzureRelayReceiver Class Introduction Properties AccessKey AccessKeyName Connected AzureRelayConnectionCount AzureRelayConnectionAcceptData AzureRelayConnectionAddress AzureRelayConnectionBytesSent AzureRelayConnectionConnected AzureRelayConnectionConnectHeaders AzureRelayConnectionConnectionId AzureRelayConnectionDataFormat AzureRelayConnectionDataToSend AzureRelayConnectionExtensions AzureRelayConnectionHost AzureRelayConnectionId AzureRelayConnectionReadyToSend AzureRelayConnectionRemoteAddress AzureRelayConnectionRemotePort AzureRelayConnectionSubProtocols AzureRelayConnectionTimeout DefaultTimeout FirewallAutoDetect FirewallType FirewallHost FirewallPassword FirewallPort FirewallUser ForwardingHost ForwardingPort HybridConnection Listening LocalHost NamespaceAddress ProxyAuthScheme ProxyAutoDetect ProxyPassword ProxyPort ProxyServer ProxySSL ProxyUser SSLAcceptServerCertEncoded SSLCertEncoded SSLCertStore SSLCertStorePassword SSLCertStoreType SSLCertSubject SSLServerCertEncoded Methods Config Disconnect DoEvents Interrupt Send SendFile SendHTTPResponse SendText Shutdown Events Connected ConnectionConnected ConnectionDataIn ConnectionDisconnected ConnectionError ConnectionReadyToSend ConnectionRequest ConnectionStatus Disconnected Error Header HTTPRequest Log Redirect SSLServerAuthentication SSLStatus Configuration Error Codes AzureRelaySender Class Introduction Properties AcceptData AccessKey AccessKeyName BytesSent Connected DataFormat DataToSend FirewallAutoDetect FirewallType FirewallHost FirewallPassword FirewallPort FirewallUser HybridConnection LocalHost LocalPort NamespaceAddress OtherHeaders ParsedHeaderCount ParsedHeaderField ParsedHeaderValue ProxyAuthScheme ProxyAutoDetect ProxyPassword ProxyPort ProxyServer ProxySSL ProxyUser ReadyToSend SSLAcceptServerCertEncoded SSLCertEncoded SSLCertStore SSLCertStorePassword SSLCertStoreType SSLCertSubject SSLServerCertEncoded SubProtocols Timeout TransferredHeaders Methods Config Connect Disconnect DoEvents Interrupt Reset Send SendFile SendText Events Connected ConnectionStatus DataIn Disconnected Error Header Log ReadyToSend Redirect SSLServerAuthentication SSLStatus Configuration Error Codes CertMgr Class Introduction Properties CertEffectiveDate CertEncoded CertExpirationDate CertExtendedKeyUsage CertFingerprint CertIssuer CertKeyPassword CertPrivateKey CertPrivateKeyAvailable CertPrivateKeyContainer CertPublicKey CertPublicKeyAlgorithm CertPublicKeyLength CertSerialNumber CertSignatureAlgorithm CertSubject CertSubjectAltNames CertThumbprintMD5 CertThumbprintSHA1 CertThumbprintSHA256 CertUsage CertUsageFlags CertVersion CertExtensionCount CertExtensionCritical CertExtensionOID CertExtensionValue CertStore CertStorePassword CertStoreType ExportedCert ExportFormat ExportPrivateKey Methods Config CreateCertificate CreateKey DeleteCertificate DeleteKey ExportCertificate GenerateCSR ImportCertificate ImportSignedCSR IssueCertificate ListCertificateStores ListKeys ListMachineStores ListStoreCertificates ReadCertificate ReadCSR Reset SaveCertificate ShowCertificateChain SignCSR Events CertChain CertList Error KeyList Log StoreList Configuration Error Codes JSON Class Introduction Properties BuildDOM InputData InputFile OutputData OutputFile Overwrite Validate XChildCount XChildName XChildXText XElement XElementType XErrorPath XParent XPath XSubTree XText Methods Config EndArray EndObject Flush HasXPath InsertProperty InsertValue LoadSchema Parse PutName PutProperty PutRaw PutValue Remove Reset Save SetInputStream SetName SetOutputStream SetValue StartArray StartObject TryXPath Events Characters EndDocument EndElement Error IgnorableWhitespace JSON StartDocument StartElement Types IPWorksMQStream Configuration Error Codes MQTT Class Introduction Properties CleanSession ClientId Connected FirewallAutoDetect FirewallType FirewallHost FirewallPassword FirewallPort FirewallUser IncomingMessageCount IncomingMessageContentType IncomingMessageCorrelationData IncomingMessageDuplicate IncomingMessageMessage IncomingMessageMessageExpInterval IncomingMessagePacketId IncomingMessagePayloadFormatIndicator IncomingMessageQoS IncomingMessageResponseTopic IncomingMessageRetained IncomingMessageState IncomingMessageSubscriptionIdentifiers IncomingMessageTopic IncomingMessageTopicAlias KeepAliveInterval LocalHost LocalPort OutgoingMessageCount OutgoingMessageContentType OutgoingMessageCorrelationData OutgoingMessageDuplicate OutgoingMessageMessage OutgoingMessageMessageExpInterval OutgoingMessagePacketId OutgoingMessagePayloadFormatIndicator OutgoingMessageQoS OutgoingMessageResponseTopic OutgoingMessageRetained OutgoingMessageState OutgoingMessageSubscriptionIdentifiers OutgoingMessageTopic OutgoingMessageTopicAlias Password ReadyToSend RemoteHost RemotePort SSLAcceptServerCertEncoded SSLCertEncoded SSLCertStore SSLCertStorePassword SSLCertStoreType SSLCertSubject SSLEnabled SSLServerCertEncoded Timeout User Version WillMessage WillTopic Methods Config Connect Disconnect DoEvents Interrupt PublishData PublishMessage Reset RestoreSession SaveSession Subscribe Unsubscribe Events Connected ConnectionStatus Disconnected Error Log MessageAck MessageIn MessageOut ReadyToSend SSLServerAuthentication SSLStatus Subscribed Unsubscribed Configuration Error Codes STOMP Class Introduction Properties Connected ContentType FirewallAutoDetect FirewallType FirewallHost FirewallPassword FirewallPort FirewallUser HeaderCount HeaderKey HeaderValue IncomingHeartbeat LocalHost LocalPort OutgoingHeartbeat ParsedHeaderCount ParsedHeaderKey ParsedHeaderValue Password ReadyToSend RemoteHost RemotePort RequestReceipts SSLAcceptServerCertEncoded SSLCertEncoded SSLCertStore SSLCertStorePassword SSLCertStoreType SSLCertSubject SSLEnabled SSLServerCertEncoded SubscriptionCount SubscriptionDestination SubscriptionId Timeout TransactionId User Methods AbortTransaction AddHeader BeginTransaction CommitTransaction Config Connect Disconnect DoEvents Interrupt Reset ResetHeaders SendData SendMessage Subscribe Unsubscribe Events Connected ConnectionStatus Disconnected Error Log MessageIn MessageOut ReadyToSend ReceiptIn ReceiptOut SSLServerAuthentication SSLStatus Subscribed Unsubscribed Configuration Error Codes XMPP Class Introduction Properties AuthDomain AuthMethods BuddyCount BuddyGroup BuddyId BuddyNickName BuddyRealName BuddySubscription Connected FirewallAutoDetect FirewallType FirewallHost FirewallPassword FirewallPort FirewallUser IMPort IMServer LocalDirectory LocalFile LocalHost MessageHTML MessageOtherData MessageSubject MessageText MessageThread MessageType Password Presence Resource ServerDomain SSLAcceptServerCertEncoded SSLCertEncoded SSLCertStore SSLCertStorePassword SSLCertStoreType SSLCertSubject SSLEnabled SSLServerCertEncoded SSLStartMode Status Timeout User UserDomain UserInfoCount UserInfoField UserInfoValue Methods Add Cancel ChangePassword ChangePresence Config Connect Disconnect DoEvents Interrupt ProbePresence QueryRegister Register Remove Reset RetrieveRoster SendCommand SendFile SendMessage SetUserInfoField SubscribeTo Unregister UnsubscribeTo Events BuddyUpdate Connected ConnectionStatus Disconnected EndTransfer Error IQ MessageIn PITrail Presence ReadyToSend SSLServerAuthentication SSLStatus StartTransfer SubscriptionRequest Sync Transfer Configuration Error Codes Software License	CreateChannel Method Creates a new channel. Syntax C++ Objective-C C ANSI (Cross Platform) int CreateChannel(const char* lpszChannelName); Unicode (Windows) INT CreateChannel(LPCWSTR lpszChannelName); - (void)createChannel:(NSString)channelName; #define MID_AMQPCLASSIC_CREATECHANNEL 9* IPWORKSMQ_EXTERNAL int IPWORKSMQ_CALL IPWorksMQ_AMQPClassic_Do(void lpObj, int methid, int cparam, void param[], int cbparam[], int64 lpllVal); Remarks This method creates a new channel with the name ChannelName* and adds it to the Channel* properties. If a channel with the given ChannelName already exists, an error will be thrown. Connecting and Creating a Channel view source `// The examples in this documentation use a RabbitMQ server, which requires SASL Plain auth.` `amqpc1.AuthScheme = AmqpclassicAuthSchemes.smSASLPlain;` `amqpc1.User =` `"guest";` `amqpc1.Password =` `"guest";` `amqpc1.SSLEnabled =` `true;` `amqpc1.Connect("amqpclassic.test-server.com", 5671);` `amqpc1.CreateChannel("channel");` 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.)
Copyright (c) 2022 /n software inc. - All rights reserved. IPWorks MQ 2020 C++ Edition - Version 20.0 [Build 8155]

IPWorks MQ 2020 C++ Edition

CreateChannel Method

Syntax

Remarks

Error Handling (C++)

Questions / Feedback?