WebServiceCall Class

The base/abstract class from which all WebServiceCall implementations are derived. Key functions of this class include:

Signing and encrypting web service requests.
Decrypting and verifying web service responses.
Validation of session codes (to prevent replay attacks).
Providing a common means in which web service requests may be generated and responses may be processed, regardless of whether or not direct Internet connectivity is being used.

Web services presently implemented include:

Name	Description
XmlActivationService	Includes methods for Electronic License Activation, status checking, and deactivation.
XmlLicenseFileService	Used for retrieving and refreshing License Files electronically.
XmlLicenseService	Used for retrieving and sending license data (such as checks for product updates, customer registration, etc...).
XmlNetworkFloatingService	Used for SOLO Server-based Network Floating licensing implementations. This allows limiting the number of concurrent users/open sessions, status checking, closing sessions, and provides a means to "check-out" sessions for off-line use (when allowed) and to "check-in" any checked-out sessions when off-line use is no longer required.

Remarks

Note
By default, the .NET Framework sets the user-agent in the HTTP header to "Mozilla/4.0 (compatible; MSIE 6.0; MS Web Services Client Protocol x.x.x.x)" where x.x.x.x is the version of the common language runtime. It is possible to specify the user-agent value when using the web service references by modifying the HttpWebClientProtocol.UserAgent property .

Inheritance Hierarchy

SystemObject
com.softwarekey.Client.WebServiceWebServiceCall
More...

Namespace: com.softwarekey.Client.WebService
Assembly: PLUSManaged (in PLUSManaged.dll) Version: 5.23.4.0

Syntax

C++

Copy

public abstract class WebServiceCall : IWebServiceCall

Public MustInherit Class WebServiceCall
	Implements IWebServiceCall

public ref class WebServiceCall abstract : IWebServiceCall

The WebServiceCall type exposes the following members.

Constructors

	Name	Description
	WebServiceCall	Creates a new WebServiceCall object.

Top

Properties

	Name	Description
	ClassName	Gets or sets the class name of the WebServiceClient object.
	EncryptionKey	Gets or sets the author encryption key data.
	ErrorMessage	Gets or sets the error message returned by the web service method call. (See http://www.softwarekey.com/go/?ID=20 for a list of possible values.)
	LastError	Gets or sets the last error which occurred.
	MethodName	Gets or sets the name of the method which will be called from the WebServiceClient object.
	RequireSsl	Gets or sets whether or not SSL certificate validation to check.
	ResultCode	Gets or sets the result code returned by the web service method call. (See http://www.softwarekey.com/go/?ID=20 for a list of possible values.)
	SessionCode	Gets or sets the randomized session code (used to deter replay attacks).
	SessionCodeValidation	Gets or sets whether or not session code validation should be done automatically.
	UseDigitalSignature	Gets or sets whether or not a digital signature is to be used or is required for the web service call. (This can only be set to false if UseEncryption is already set to false.)
	UseEncryption	Gets or sets whether or not encryption is to be used or is required for the web service call.
	WebServiceClient	Gets or sets the SoapHttpClientProtocol object (.NET Framework) or the XmlWebService object (.NET Standard 2.0) used to perform the web service method call.
	WebServiceResponse	Gets or set the XmlNode object reference for the root XML node of the web service response.

Top

Methods

	Name	Description
	AppendSessionCode(String)	Appends the SessionCode value to an XML request string depending on the SessionCodeValidation setting, and returns the updated XML string
	AppendSessionCode(XmlDocument)	Appends the SessionCode value to an XmlDocument depending on the SessionCodeValidation setting, and returns the updated XML string
	CallWebService	Calls the web service method.
	Equals	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	Finalize	Allows an Object to attempt to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)
	GenerateEncryptedRequest	Generates an encrypted web service call XML request string.
	GeneratePlainTextRequest	Generates a plain-text web service call XML request string.
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	ParseSOLOServerStatus	Parses a status string returned by SOLO Server web services.
	ProcessResponse(String)	Processes a web service response XML string.
	ProcessResponse(XmlNode)	Processes a web service response XML.
	ResetSessionCode	Sets the SessionCode value to a new, randomized value.
	ToString	Returns a String that represents the current Object. (Inherited from Object.)
	ValidateWebServiceResponseFormat	Verifies the format of the response received is such that expected and required content can be found and parsed.

Top

Reference

com.softwarekey.Client.WebService Namespace

Inheritance Hierarchy