GitHub    Download    Forum
Overview
Tutorial
C++ API
General interfaces
Data interfaces
Schema interfaces
Configuration interfaces
Callback interfaces
Structures
Error codes
DataAccess interfaces
Connection
WDomain
Domain_Create
Domain_Destroy
AbortTransaction
Cleanup
Create
CreateTransaction
DestroyTransaction
Execute
GetConnection
GetDomain
GetFlags
GetLastError
GetSchema
GetStorage
Initialize
InsertNamedLink
Open
QueryNamedLink
QueryNamedLinkFull
QueryNamedLinkFullMultiple
QueryNamedLinkId
RemoveNamedLink
ResetTransaction
SetFlags
Uninitialize
WObject
WBase
C# API
WinRT API
DTDL
DADL
Setup

WDomain::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