wstring NagGuiCalls::CallConnectorAsync	(	wstring	szwProduct,
		wstring	szwVersion,
		wstring	szwCallName,
		params	pInData
	)

Asynchronously calls the specified method (a GUI call) on the remote host.

Asynchronously connects to the remote host (if hasn't connected yet), and makes call with the specified name szwCallName.
Results are available in output parameter pStateData of the AsyncActionStateChecker::CheckActionState when the last returns the final state (bFinalized=true):

KLCONN_GUI_CALL_RESULTS subcontainer of the pStateData container
KLCONN_GUI_CALL_RESCODE value of type paramInt, see Possible values of KLCONN_GUI_CALL_RESCODE
KLBLAG_ERROR_INFO subcontainer of the pStateData container, see Asynchronous action error format

Parameters:

szwProduct	product name
szwVersion	product settings compatibility version
szwCallName	remote call name
pInData	call-specific input data

Returns:: asynchronous request ID, used to get the result

Remarks:: Check the operation state by calling AsyncActionStateChecker::CheckActionState periodically until it's finalized. If the operation succeeds then AsyncActionStateChecker::CheckActionState returns call-results in KLCONN_GUI_CALL_RESULTS subcontainer of the pStateData container Otherwise, a call to AsyncActionStateChecker::CheckActionState returns error in pStateData.

Exceptions:

Throws exception in case of error, see Some error definitions