GetName

Description

Gets the name for the current execution context.

Applies to

ContextInformation objects

Syntax

servicereference.GetName ( name )

Argument

Description

servicereference

Reference to the ContextInformation service instance.

name

String into which the function places the name. This argument is passed by reference.

Returns

Integer. Returns 1 if the function succeeds and -1 if an error occurs.

Usage

Call this function to determine the current execution environment.

The window plug-in and window ActiveX contexts are obsolete in the current version of PowerBuilder. For PowerBuilder 11.5 applications, the only value passed for the name argument is “PowerBuilder Runtime”.

Examples

Example 1

This example calls the GetName function. ci is an instance variable of type ContextInformation:

String ls_name


this.GetContextService("ContextInformation", ci)

ci.GetName(ls_name)

IF ls_name <> "PowerBuilder Runtime" THEN

   cb_close.visible = FALSE

END IF

See also