S_OK = The entity was recognized and an ID was assigned.
E_FAIL = The entity was not recognized. No ID was assigned.
Remarks
This function is rarely used in a client environment.
The Design will only recognize certain types of interfaces, such as IObject, IPort, IFailureEffect, etc. By "unrecognized entity", it means that the IDesign does not support a mechanism for assigning ID's to the type of entity passed in.
Note: eXpress utilizes this function heavily inside its own COM services. Any time a collection is used to add new entities, this function is called automatically. Therefore, this function is rarely called.