Member Functions

virtual IQueue_manager_connection* mi::​neuraylib::​IQueue_manager_api::connect( const char* address, const char* user_name, const char* password, Sint32* errors = 0) [pure virtual]

Creates a connection to a queue manager server.

Parameters

address

The web socket URL of the queue manager. If the queue manager server listens on host "somehost" and port 80, then the client will connect using the URL "ws://somehost:80/". If the connection is encrypted using the SSL protocol, then the prefix "wss" needs to be used instead of "ws". Note that the port must be specified. The standard port for web sockets is 80 and 443 for secure web sockets. Queue manager instances running on the VCA use SSL and run on port 443. The corresponding URL of the Iray Bridge server to upload scenes and to create snapshots can be obtained by appending "/iray_server_bridge.ws".

user_name

The user name to be used for logging into the queue manager.

password

The password to be used for logging into the queue manager.

errors

An optional pointer to an mi::Sint32 to which an error code will be written. The error codes have the following meaning:

• 0: Success.
• -1: The connection failed. Please check the server address.
• -2: The authentication failed. Please check user name and password.
• -3: Incompatible queue manager protocol version.
• -4: Invalid server response.
• -5: Incompatible bridge protocol version.
• -6: Unknown error.
• -7: Invalid arguments (NULL pointer).

Returns

The queue manager connection, or NULL in case of failures.