Namespace: OpenEdge.Core
Type: Class Session
Parent Classes:
Progress.Lang.Object

Inherits: Progress.Lang.Object


Copyright (c) 2013, 2018-2019, 2021 by Progress Software Corporation. All rights reserved.
File:Session
Purpose:An extension of the SESSION system handle.
Description:Session object : this object lives for the lifespan of
an AVM Session.
Author(s):pjudge
Created:Fri Jun 04 15:00:56 EDT 2010
Notes:* Discover handle- and object- references for given names
Purpose: Returns the first running persistent procedure instance found
for a given name.
there's no running instance of that name.



Method Summary
  Options Name Purpose
  OpenEdge.Core.Collections.Array GetAllInstances (Class) /** Returns all the object instances found that are of the type given. @param Class The type. This can be a class or an interface. @return Object The reference to that type, if any. Unknown value if there's no running instance of that name. */
  OpenEdge.Core.Collections.Array GetAllRunningProcs (character) /** Returns all the running persistent procedure instances found for a given name. @param character The (relative) path name for a procedure. @return handle An array of handles to that procedure, if any. If there's no running instance of that name, then the array has an extent of 1 (one) which contains the unknown value. */
  Progress.Lang.Object GetFirstClassInstance (Class) /** Returns the first object instance found that is of the type given. @param Class The type. This can be a class or an interface. @return Object The reference to that type, if any. Unknown value if there's no running instance of that name. */
  OpenEdge.Core.WidgetHandle GetFirstRunningProc (character) /** Returns the first running persistent procedure instance found for a given name. @param character The (relative) path name for a procedure. @return handle The handle to that procedure, if any. Unknown value if there's no running instance of that name. */
  Progress.Lang.Object ResolveWeakReference (int64) /** Resolves a weak reference into an object instance. A weak reference is an int64 representation of an object reference. This method is analogous to the WIDGET-HANDLE() function. Notes: * Based on http://msdn.microsoft.com/en-us/library/ms404247(v=VS.90).aspx * Performance of ResolveWeakReference() will probably suck. * An ABL statement "OBJECT-REFERENCE(int)" would entirely replace this method. @param int64 A weak reference to an object. @return Object The object instance corresponding to that reference. The unknown value/null is returned if the referecen cannot be resolved. */

Method Detail
Top

OpenEdge.Core.Collections.Array GetAllInstances (Class)

Purpose: Returns all the object instances found that are of the type given.
there's no running instance of that name.
Parameters:
poType Progress.Lang.Class
 
Returns OpenEdge.Core.Collections.Array
  Object The reference to that type, if any. Unknown value if
Top

OpenEdge.Core.Collections.Array GetAllRunningProcs (character)

Purpose: Returns all the running persistent procedure instances found
for a given name.
If there's no running instance of that name, then
the array has an extent of 1 (one) which contains the
unknown value.
Parameters:
pcName CHARACTER
 
Returns OpenEdge.Core.Collections.Array
  handle An array of handles to that procedure, if any.
Top

Progress.Lang.Object GetFirstClassInstance (Class)

Purpose: Returns the first object instance found that is of the type given.
there's no running instance of that name.
Parameters:
poType Progress.Lang.Class
 
Returns Progress.Lang.Object
  Object The reference to that type, if any. Unknown value if
Top

OpenEdge.Core.WidgetHandle GetFirstRunningProc (character)

Purpose: Returns the first running persistent procedure instance found
for a given name.
there's no running instance of that name.
Parameters:
pcName CHARACTER
 
Returns OpenEdge.Core.WidgetHandle
  handle The handle to that procedure, if any. Unknown value if
Top

Progress.Lang.Object ResolveWeakReference (int64)

Purpose: Resolves a weak reference into an object instance. A weak reference is an int64
representation of an object reference. This method is analogous to the WIDGET-HANDLE()
function.
Notes: * Based on http://msdn.microsoft.com/en-us/library/ms404247(v=VS.90).aspx
is returned if the referecen cannot be resolved.
Parameters:
piReference INT64
 
Returns Progress.Lang.Object
  Object The object instance corresponding to that reference. The unknown value/null