ReleaseAutomationNativePointer PowerScript function

Description

Releases the pointer to an OLE object that you got with GetAutomationNativePointer.

Controls

OLEObject

Syntax

<span>oleobject</span>.<span>ReleaseAutomationNativePointer</span> ( <span>pointer</span> )

1	<span>oleobject</span>.<span>ReleaseAutomationNativePointer</span> ( <span>pointer</span> )

Argument	Description
oleobject	The name of an OLEObject variable containing the object for which you want to release the native pointer.
pointer	A UnsignedLong variable that holds the pointer you want to release. ReleaseAutomationNativePointer sets pointer to 0 so that it is clearly no longer a valid pointer.

Return Values

Integer. Returns 0 if it succeeds and
-1 if an error occurs.

Usage

Pointer is a pointer to OLE’s
IUnknown interface. You can use IUnknown::QueryInterface to
get other interface pointers.

When you call GetAutomationNativePointer,
PowerBuilder calls OLE’s AddRef function,
which locks the pointer. You can release the pointer in your DLL function
or in a PowerBuilder script with the ReleaseAutomationNativePointer function.

Examples

See GetAutomationNativePointer.

Connection Information

ReleaseAutomationNativePointer – PB Docs 125