GitHub    Download    Forum
Overview
Tutorial
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
C# API
WinRT API
DTDL
DADL
Setup

UStorage::InsertExternLink

Inserts an extern link to the domain.

Syntax

HRESULT InsertExternLink(
[in] const stcObjectLink* p_polObjectLink,
[in] HANDLE p_hActionGroup
);
 
HRESULT InsertExternLink(
[in] const ObjectId* p_poiObjectId,
[in] const UINT32* p_aulClassId,
[in] UINT32 p_ulClassCount,
[in] HANDLE p_hActionGroup
);

Parameter

p_polObjectLink [in]
Type: const stcObjectLink*
ObjectLink to the object to insert as an extern link.
p_poiObjectId [in]
Type: const ObjectId*
ObjectId of the ObjectLink to insert as an extern link.
p_aulClassId [in]
Type: const UINT32*
Class list of the ObjectLink to insert as an extern link.
p_ulClassCount [in]
Type: UINT32
Number of elements in the p_aulClassId array.
p_hActionGroup [in]
Type: HANDLE
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