GitHub    Download    Forum
Overview
Tutorial
C++ API
C# API
General interfaces
Data interfaces
UDomain
UStorage
AbortActionGroup
AddClass
ClassAddRef
ClassAddRefById
ClassRelease
ClassReleaseById
Close
Create
CreateActionGroup
CreateWaitObject
DestroyActionGroup
DestroyWaitObject
Execute
ExecuteAsync
ExecuteResult
ExecuteWait
GetLastError
GetSchema
InsertExternLink
InsertNamedLink
InsertNamedObject
Load
Open
RegisterEventClient
RemoveExternLink
RemoveNamedLink
RemoveNamedObject
ResetActionGroup
SetLastError
SetSchema
Store
UnregisterEventClient
Update
WaitableHandle
UObject
UList
UBitFlagSet
UBitFlagSetSingle
WDomain
WObject
IEventClient
Schema interfaces
Configuration interfaces
Callback interfaces
Structures
Error codes
DataAccess interfaces
WinRT API
DTDL
DADL
Setup

UStorage.InsertExternLink

Inserts an extern link to the domain.

Syntax

int InsertExternLink(
stcObjectLink p_polObjectLink,
IntPtr p_hActionGroup
);
 
int InsertExternLink(
ObjectId p_poiObjectId,
UInt32[] p_aulClassId,
IntPtr p_hActionGroup
);

Parameter

p_polObjectLink
Type: stcObjectLink
ObjectLink to the object to insert as an extern link.
p_poiObjectId
Type: ObjectId
ObjectId of the ObjectLink to insert as an extern link.
p_aulClassId
Type: UInt32[]
Class list of the ObjectLink to insert as an extern link.
p_hActionGroup
Type: IntPtr
ActionGroup to use.

Return value

S_OK or an error from the Error Codes.

Remarks

This function creates an 'external' reference. It is not under the control of the database and needs to be released using UStorage.RemoveExternLink.
Use this function only if you need to store an ObjectId outside of the database and want to keep the object alive during this time.
© 2025 Mobiland AG