An API component which can be used to create a connection to a queue manager. More...

Inheritance diagram for mi::neuraylib::IQueue_manager_api:

Public Member Functions
virtual IQueue_manager_connection *	connect (const char address, const char user_name, const char password, Sint32 errors=0)=0
	Creates a connection to a queue manager server. More...

Additional Inherited Members
Public Types inherited from mi::base::Interface_declare< 0x2bdfce73, 0x762c, 0x4b15, 0x94, 0xdf, 0x4e, 0xec, 0xc5, 0x7d, 0xbf, 0x88 >
typedef Interface_declare< id1, id2, id3, id4, id5, id6, id7, id8, id9, id10, id11, IInterface >	Self
	Own type. More...

typedef Uuid_t< id1, id2, id3, id4, id5, id6, id7, id8, id9, id10, id11 >	IID
	Declares the interface ID (IID) of this interface. More...

Static Public Member Functions inherited from mi::base::Interface_declare< 0x2bdfce73, 0x762c, 0x4b15, 0x94, 0xdf, 0x4e, 0xec, 0xc5, 0x7d, 0xbf, 0x88 >
static bool	compare_iid (const Uuid &iid)
	Compares the interface ID `iid` against the interface ID of this interface and of its ancestors. More...

Detailed Description

An API component which can be used to create a connection to a queue manager.

Member Function Documentation

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.
[out]	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).