UnbindObj Method

Applies To

OBinder

Description

This method breaks the connection between the OBinder and one of its Abound objects.

Usage

oresult UnbindObj(Abound *bobj, oboolean nofail = FALSE)

Arguments

Arguments	Description
bobj	The Abound object that is being unbound.
nofail	TRUE if you unbind despite Shutdown trigger failure; FALSE if you are willing to have the Unbind fail.

Remarks

This method unbinds the Abound object *bobj and calls the Shutdown trigger on *bobj. If nofail is TRUE, this method unbinds the object even if the Shutdown trigger returns OFAILURE - that is, the unbinding cannot fail. If nofail is FALSE and the Shutdown trigger returns OFAILURE, the object is not unbound.

If the Unbinding is successful, neither the OBinder nor the Abound is destroyed. Only their relationship is terminated.

Return Value

An oresult indicating whether the operation succeeded (OSUCCESS) or not (OFAILURE).