GitHub Download Forum

UStorage.InsertNamedLink

Inserts a named link 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 InsertNamedLink(
	stcObjectLink	p_polObjectLink,
	Guid	p_guidName,
	String	p_strName,
	IntPtr	p_hActionGroup
);

int InsertNamedLink(
	ObjectId	p_poiObjectId,
	UInt32[]	p_aulClassId,
	Guid	p_guidName,
	String	p_strName,
	IntPtr	p_hActionGroup
);

Parameter

p_polObjectLink

Type: stcObjectLink

ObjectLink to the object to insert as a named link.

p_poiObjectId

Type: ObjectId

ObjectId of the ObjectLink to insert as a named link.

p_aulClassId

Type: UInt32[]

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

p_guidName

Type: Guid

ID (name) of the new named link.

p_strName

Type: String

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

p_hActionGroup

Type: IntPtr

ActionGroup to use.

Return value

S_OK or an error from the Error Codes.