GitHub Download Forum

WDomain::Create

Creates a new WObject.

Syntax

HRESULT Create(
	[out]	WObject**	p_ppObject,
	[in]	const DataFoundation::ObjectId*	p_poiParentId,
	[in]	const UINT32*	p_aulClassId,
	[in]	UINT32	p_ulClassCount
);

Parameter

p_ppObject [out]

Type: WObject**

Pointer to a variable that receives the interface pointer of the new object.

The variable contains the interface pointer on successful return. The variable is not modified on failure.

Call WObject::Release on the pointer when you no longer need it.

p_poiParentId [in]

Type: const DataFoundation::ObjectId*

ID of the parent object.

Remarks: A "parent" object is not really a parent. This information is only used by the system for load optimizations to determine which objects will likely be used at the same time.

p_aulClassId [in]

Type: const UINT32*

Array of classes the object contains.

p_ulClassCount [in]

Type: UINT32

Number of elements in the p_aulClassId array.

Return value

S_OK or an error from the Error Codes.

Remarks

This function only creates a temporary object. You need to call WDomain::StoreData and WDomain::Execute or WDomain::ExecuteAsync to create the object in the database.