Open topic with navigation

SK_PLUS4_PostEvalDataRequest 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_PostEvalData and SK_PostEvalDataEx functions.

Remarks

After calling this function to generate the URL needed, you can submit the request to the server using the SK_HttpRequest function (you can use a URL of "secure.softwarekey.com/solo/products/trialsignup.asp" for SOLO Server Shared URL), and parse the server's response using SK_PLUS4_PostEvalDataResponse.

Syntax

C/C++

SK_ResultCode SK_PLUS4_PostEvalDataRequest(SK_ApiContext context, int flags, int productId, const char *email, const char *companyName, int distributorId, const char *firstName, const char *lastName, const char *address1, const char *address2, const char *city, const char *stateProvince, const char *postalCode, const char *country, const char *phone, const char *source, char **postString);

Visual Basic

Declare Function SK_PLUS4_PostEvalDataRequest(ByVal context As Long, ByVal flags As Long, ByVal productId As Long, ByVal email As String, ByVal companyName As String, ByVal distributorId As Long, ByVal firstName As String, ByVal lastName As String, ByVal address1 As String, ByVal address2 As String, ByVal city As String, ByVal stateProvince As String, ByVal postalCode As String, ByVal country As String, ByVal phone As String, ByVal source As String, ByRef postString As String) As Long

Arguments

context

The API Context handle.

flags

Any flags passed into this function-call.

productId

The Product ID of the protected application which is being evaluated.

email

The customer's email address.

companyName

The customer's company name (optional).

distributorId

The Distributor ID of the company which originated the evaluation/lead.

firstName

The customer's first/given name (optional).

lastName

The customer's last/family name (optional).

address1

The first line of the customer's street address (optional).

address2

The second line of the customer's street address (optional).

city

The city in which the customer is located (optional).

stateProvince

The state/province in which the customer is located (optional).

postalCode

The customer's zip/postal code (optional).

country

The country in which the customer is located (optional).

phone

The customer's phone number (optional).

source

The source of the lead, or how the customer heard about the protected application (e.g. Internet search, friend, etc...).

postString

Returns

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