SK_PLUS4_GetTcDataRequest Function

Generates a URL with the query string parameters needed for calling server-side scripts which were 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.

After calling this function to generate the URL needed, you can submit the request to the server using the SK_HttpRequest function, and parse the server's response using SK_PLUS4_GetTcDataResponse.

Syntax

C/C++
SK_ResultCode SK_PLUS4_GetTcDataRequest(SK_ApiContext context, int flags, const char *url, int licenseId, const char *password, int userCode1, int userCode2, int productId, int productOptionId, char **requestUrl);
Visual Basic
Declare Function SK_PLUS4_GetTcDataRequest(ByVal context As Long, ByVal flags As Long, ByVal url As String, ByVal licenseId As Long, ByVal password As String, ByVal userCode1 As Long, ByVal userCode2 As Long, ByVal productId As Long, ByVal productOptionId As Long, ByRef requestUrl As String) As Long

Arguments

context
The API Context handle.
flags
Any flags passed into this function-call.
url
The URL to the Automation Client script. Use "secure.softwarekey.com/solo/unlock/getcode.asp" for SOLO Server Shared URL.
licenseId
The License ID used when activating the protected application.
password
The password used when activating the protected application.
userCode1
The randomized User Code 1 value (also referred to as the session code). This value can be generated using the SK_PLUS4_GenerateUserCode1Value function.
userCode2
The User Code 2 value (also referred to as the Computer ID). This value can be generated using the SK_PLUS4_GenerateUserCode2Value function.
productId
The Product ID for which the license was created (optional).
productOptionId
The Product Option ID for which the license was created (optional).
requestUrl
Reference/pointer to a string pointer, which will point to request URL that contains the query string data needed to submit the request. 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_ARGUMENTS Some or all of the arguments are invalid.
SK_ResultCode.SK_ERROR_MEMORY_ALLOCATION Memory could not be allocated.