Syntax:
native Handle:CloneHandle(Handle:hndl, Handle:plugin=INVALID_HANDLE);
Usage:
hndl Handle to clone/duplicate.
plugin Optional Handle to another plugin to mark as the new owner. If no owner is passed, the owner becomes the calling plugin.
Notes:
Clones a Handle. When passing handles in between plugins, caching handles can result in accidental invalidation when one plugin releases the Handle, or is its owner is unloaded from memory. To prevent this, the Handle may be "cloned" with a new owner.
Return:
Handle on success, INVALID_HANDLE if not cloneable.
Version Added:
1.0.0.1946