GitHub    Download    Forum
Overview
Tutorial
C++ API
General interfaces
Data interfaces
UDomain
GetSchemaData
GetSchemaVersion
QueryNamedLink
QueryNamedLinkFull
QueryNamedLinkFullMultiple
QueryNamedLinkId
QueryNamedObject
QueryNamedObjectId
QueryNamedObjectLink
QueryNamedObjectMultiple
QueryStorage
UStorage
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

UDomain::QueryNamedLink

Returns the ObjectLink of a named link.

Syntax

HRESULT QueryNamedLink(
[in] const GUID* p_aguidName,
[in] UINT32 p_ulLength,
[out] stcObjectLink** p_paObjectLink,
[in] ISignal* p_pSignalObject
);

Parameter

p_aguidName [in]
Type: const GUID*
Array of names (GUIDs) of named links to retrieve the ObjectId from.
p_ulLength [in]
Type: UINT32
Number of elements in the p_aguidName array and the p_paObjectLink array.
p_paObjectLink [out]
Type: stcObjectLink**
Pointer to an array that receives the ObjectLinks of the named links. Caller must free the memory with MemFree.
p_pSignalObject [in]
Type: ISignal*
Pointer to a signal that is used in asynchronous execution to wait for completion and retrieve the result.
If NULL is passed, the function is executed synchronously and blocks until the result is available.

Return value

S_OK if all the requested links have been found.
S_FALSE if some links have not been found. In this case, the corresponding element in p_paObjectLink is set to OBJECTID_NULL.
If the function fails, it returns an error from the Error Codes.
© 2025 Mobiland AG