kStatus kSystem_AddServerNode	(	kSystem	system,
		kHxNode	hardwareNode,
		kSvNode *	serverNode
	)

Adds a server node to the system.

This function creates a FireSync server node. Server nodes are created within the same operating system process as the caller. After adding a server node to the system, low-level server configuration can be performed by calling kSvNode methods. Note, the kSystem instance owns the server node; the handle returned by this method should not be destroyed by the caller.

A server node is represented in the context of kSystem by a kNode object. After calling kSystem_AddServerNode to create the node, a kNode handle associated with the server can be accessed via kSystem and used to perform high-level configuration and control operations.

The hardware node passed to this function is used as the backend for the server node. If the caller constructed the hardware node, it can be destroyed by the caller after this method returns. The server node will manipulate the hardware node's reference count as needed to control its lifetime.

Note: kSystem_Refresh is called automatically by this method.

Parameters

system	kSystem object.
hardwareNode	Hardware node that provides underlying platform services (see remarks on ownership).
serverNode	Receives server node handle, which can be used for additional configuration (see remarks on ownership).

Returns

Operation status.

See also

kHxNode, kSvNode, kSystem_RemoveServerNode