GitHub Download Forum

WDomain.InsertNamedObject

Inserts a named object to the domain. It allows users to use a well-known ID (name) to retrieve an object. This ID can be the same on multiple domains, while the ObjectIds are generated by the database internally and are unique in every installation.

Syntax

int InsertNamedObject(
	DataFoundation.stcObjectLink	p_polObjectLink,
	Guid	p_guidName,
	String	p_strName,
	IntPtr	p_hTransaction
);

int InsertNamedObject(
	DataFoundation.ObjectId	p_poiObjectId,
	UInt32	p_aulClassId,
	Guid	p_guidName,
	String	p_strName,
	IntPtr	p_hTransaction
);

Parameter

p_polObjectLink

Type: DataFoundation.stcObjectLink

ObjectLink to the object to insert as a named object.

p_poiObjectId

Type: DataFoundation.ObjectId

ObjectId of the ObjectLink to insert as a named object.

p_aulClassId

Type: UInt32

Class list of the ObjectLink to insert as a named object.

p_guidName

Type: Guid

ID (name) of the new named object.

p_strName

Type: String

Description or friendly name of the new named object. This name is used in a GUI or for interaction with users. It cannot be used for retrieving the named object.

p_hTransaction

Type: IntPtr

Handle to a transaction.

Can be the standard transaction Transaction::Store.

Return value

S_OK or an error from the Error Codes.