GitHub Download Forum

WDomain::InsertNamedObject

Inserts a named object to the domain. It allows users to use a well-known ID (name) to retrieve an object. This ID can be the same on multiple domains, while the ObjectIds are generated by the database internally and are unique in every installation.

Syntax

HRESULT InsertNamedObject(
	[in]	const DataFoundation::stcObjectLink*	p_polObjectLink,
	[in]	const GUID*	p_pguidName,
	[in]	const wchar_t*	p_strName,
	[in]	HANDLE	p_hTransaction
);

HRESULT InsertNamedObject(
	[in]	const DataFoundation::ObjectId*	p_poiObjectId,
	[in]	UINT32*	p_aulClassId,
	[in]	UINT32	p_ulClassCount,
	[in]	const GUID*	p_pguidName,
	[in]	const wchar_t*	p_strName,
	[in]	HANDLE	p_hTransaction
);

Parameter

p_polObjectLink [in]

Type: const DataFoundation::stcObjectLink*

ObjectLink to the object to insert as a named object.

p_poiObjectId [in]

Type: const DataFoundation::ObjectId*

ObjectId of the ObjectLink to insert as a named object.

p_aulClassId [in]

Type: UINT32*

Class list of the ObjectLink to insert as a named object.

p_ulClassCount [in]

Type: UINT32

Number of elements in the p_aulClassId array.

p_pguidName [in]

Type: const GUID*

ID (name) of the new named object.

p_strName [in]

Type: const wchar_t*

Description or friendly name of the new named object. This name is used in a GUI or for interaction with users. It cannot be used for retrieving the named object.

p_hTransaction [in]

Type: HANDLE

Handle to a transaction.

Can be the standard transaction Transaction::Store.

Return value

S_OK or an error from the Error Codes.