If a persistent class is GUIDENABLED then this method can be called to override the default GUID assignment. This method accepts a guid value and returns the override value currently assigned. The return value will only differ from the supplied value if the override is unsuccessful. It is only valid to call this method on a new object. The guid value passed to this method is not validated. It is up to the user to make sure the guid is properly formed. The guid assignment does not actually occur until the object is saved. If the object has already been assigned a GUID or if the GUID override value has already been assigned to another object then the GUID override value will be discarded. The check for GUID value uniqueness and a GUID value previously assigned is done only at the time the object is saved and is not performed by this method.