GitHub Download Forum

WDomain.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(
	DataFS.stcObjectLink	p_polObjectLink,
	Guid	p_guidName,
	String	p_strName,
	IntPtr	p_hTransaction
);

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

Parameter

p_polObjectLink

Type: DataFS.stcObjectLink

ObjectLink to the object to insert as a named link.

p_poiObjectId

Type: DataFS.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_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.