Bob,
<"Makes the passed business object the primary business object.") implies that the passed object will be made the primary business object regardless of the initial design. >
My apologies for any confusion...however, in most cases, you really don't want it to change the business object in the way that you describe. If you want to set another object as the true primary business object, simply change the lPrimaryBizObj and the form's oPrimaryBizObj properties accordingly.
Regards,
Kevin McNeish
Eight-Time .NET MVP
VFP and iOS Author, Speaker & Trainer
Oak Leaf Enterprises, Inc.
Chief Architect, MM Framework
http://www.oakleafsd.com