DotNetAddHeader (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / WLanguage functions / Communication / .Net functions

Procedure execution

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

DotNetAddHeader (Function)

In french: DotNetAjouteEntête

Adds a header to the next procedure that will be run on the server. This header contains an additional parameter. This parameter is used to check a specific information on the server (type of security for example).

Note This procedure will be executed by function DotNetRun or DotNetRunXML.

Example

// Ajout d'un entête à la prochaine procédure DotNet exécutée
// Cet entête permet de vérifier le niveau de sécurité informatique
// utilisé par le serveur
// Si le niveau de sécurité maximum n'est pas utilisé, la prochaine
// procédure DotNet ne sera pas exécutée
DotNetAddHeader("Sécurité", "SécuritéMax", "Sécurité-Niveau", True)

Syntax

DotNetAddHeader(<Parameter name> , <Parameter value> , <Parameter namespace> [, <Procedure execution>])

<Parameter name>: Character string

Name of additional parameter. This additional parameter is used to check an information specific to the server. This parameter is supplied in the documentation of .Net server.
The name of the parameter is case sensitive.

<Parameter value>: Any type

Value of additional parameter. The possible values are supplied in the documentation for the server of .Net XML web services.

<Parameter namespace>: Character string

Namespace of parameter. This parameter is supplied in the documentation of .Net server.

<Procedure execution>: Optional boolean

True Procedure should not be executed if the server cannot process the header (header required).
False Procedure execution does not take header into account (optional header).

Remarks

Procedure execution

You have the ability to run (or not) the next procedure by adding a header. To do so, <Procedure execution> must be initialized to True.

If <Procedure execution> is initialized to True:

DotNetRun (or DotNetRunXML) returns True if the connection with the server has been established, False otherwise.
If the connection with the server was established and if the server fulfills the conditions requested by the header, the procedure is run.
If the procedure was run, DotNetGetResult returns:
- the result of the procedure if the procedure was successfully run,
- an empty string ("") if the procedure failed.
If the procedure failed or if it was not run, DotNetError returns:
- the "MustUnderstand" error code if the server does not fulfill the conditions requested by the header,
- an error in the other cases.

Component: wd300com.dll