SetWSObject (Deprecated)

Description

Causes a DataWindow control or DataStore to use a programmer-specified Web service connection object. The connection object provides the information necessary for communicating with a Web service data source.

Applies to

DataWindow type

Method applies to

PowerBuilder

DataWindow control, DataWindowChild object, DataStore object


Syntax

PowerBuilder

integer dwcontrol.SetWSObject ( wsconnection wsobject )

Argument

Description

dwcontrol

A reference to a DataWindow control, DataStore, or child DataWindow in which you want to use a programmer-specified Web service connection object

wsobject

The name of the connection object you want to use in the  dwcontrol


Return value

Returns 1 if it succeeds and -1 if an error occurs. If the WSConnection object is null, in PowerBuilder the method returns null.

Usage

You call the SetWSObject method to pass an instance of the WSConnection object and connect to a Web service data source, when the Web service requires user-related, session-related, or authentication information. If the Web service does not require this information, you do not need to use the WSConnection object (or call SetWSObject) to access Web service data.

Examples

The following code instantiates a WSConnection object, then sets the object as the connection object for a Web service data source:

int ii_return
wsconnection ws_1
ws_1 = create wsconnection
ws_1.username = "johndoe"
ws_1.password = "mypassword"
ws_1.endpoint = "myendpoint"
ws_1.authenticationmode = "basic"
ws_1.usewindowsintegratedauthentication = true
ii_return = dw_1.setwsobject (ws_1)

See also

SetTransObject