Connect Method

Connects to the Azure Relay Service.

Syntax

• C++
• Objective-C
• C

ANSI (Cross Platform)
int Connect();

Unicode (Windows)
INT Connect();

- (void)connect;

#define MID_AZURERELAYSENDER_CONNECT 3

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

Remarks

Connect establishes a WebSocket connection to the Azure Relay Service. The following properties are applicable when calling this method:

• AccessKey (required)
• AccessKeyName (required)
• HybridConnection (required)
• NamespaceAddress (required)
• Timeout

After the connection is established data may be sent by setting the DataToSend property or by calling Send, SendText, or SendFile.

Incoming data is received through the DataIn event.

To disconnect call the Disconnect method.

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