Releases the pointer to an OLE object that you got with GetAutomationNativePointer.
OLEObject
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. |
Integer. Returns 0 if it succeeds and -1 if an error occurs.
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.
See GetAutomationNativePointer.