ReleaseAutomationNativePointer

Description

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

Applies to

OLEObject

Syntax

oleobject.ReleaseAutomationNativePointer ( pointer )

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 value

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.

See also

GetAutomationNativePointer

GetNativePointer

ReleaseNativePointer