SK_PLUS4_GetTcDataResponse Function

Parses a response from a server-side script which was originally designed to work with the Automation Client's SK_GetTCData and SK_GetTCDataEx functions.

Remarks

In general, if you are using SOLO Server, you should be using SK_SOLO_ActivateInstallationGetRequest with SK_CallXmlWebService for activation.

Before calling this function, you need to call SK_PLUS4_GetTcDataRequest to generate the request URL, and submit the request to the server using SK_HttpRequest (which returns the response this function is meant to parse).

Syntax

C/C++
SK_ResultCode SK_PLUS4_GetTcDataResponse(SK_ApiContext context, int flags, const char *response, int *errorCode, int *activationCode1, int *activationCode2, char **licenseUpdate);
Visual Basic
Declare Function SK_PLUS4_GetTcDataResponse(ByVal context As Long, ByVal flags As Long, ByVal response As String, ByRef errorCode As Long, ByRef activationCode1 As Long, ByRef activationCode2 As Long, ByRef licenseUpdate As String) As Long

Arguments

context
The API Context handle.
flags
Any flags passed into this function-call.
response
The response returned from the server.
errorCode
Reference/pointer to an integer, which will receive the Automation Client compatible error code.
activationCode1
Reference/pointer to an integer, which will point to the Activation Code 1 value returned from the server.
activationCode2
Reference/pointer to an integer, which will point to the Activation Code 2 value returned from the server.
licenseUpdate
Reference/pointer to a string pointer, which will point to the string which contains the license update content returned from the server when the call succeeds. The string pointer must be initialized to NULL (0) prior to calling this function.

Returns

All possible return values are included in the SK_ResultCode enumeration. Return codes to expect include:

Result Code Description
SK_ResultCode.SK_ERROR_NONE No error.
SK_ResultCode.SK_ERROR_INVALID_DATA The presence of invalid data has been detected.
SK_ResultCode.SK_ERROR_INVALID_ARGUMENTS Some or all of the arguments are invalid.
SK_ResultCode.SK_ERROR_WEBSERVICE_RETURNED_FAILURE A call to a Web Service succeeded, but the functionality of the Web Service returned an indicator of failure.
SK_ResultCode.SK_ERROR_MEMORY_ALLOCATION Memory could not be allocated.