GitHub Download Forum

UDomain::QueryNamedLinkFull

Returns information about a named link.

Syntax

HRESULT QueryNamedLinkFull(
	[in]	const GUID*	p_aguidName,
	[in]	UINT32	p_ulLength,
	[out]	stcObjectLinkNamed**	p_paObjectLinkNamed,
	[in]	ISignal*	p_pSignalObject
);

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_paObjectLinkNamed array.

p_paObjectLinkNamed [out]

Type: stcObjectLinkNamed**

Pointer to an array that receives the ObjectLinkNameds 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.

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_paObjectLinkNamed is set to OBJECTID_NULL.

If the function fails, it returns an error from the Error Codes.