AwaClientSetOperation_AddArrayValueAs___

Adds a path and value to a Set Operation, as a request to change a multiple-instance resource's instance to the specified value. More...

Functions
AwaError	AwaClientSetOperation_AddArrayValueAsCString (AwaClientSetOperation *operation, const char *path, int resourceInstanceID, const char *value)
AwaError	AwaClientSetOperation_AddArrayValueAsInteger (AwaClientSetOperation *operation, const char *path, int resourceInstanceID, AwaInteger value)
AwaError	AwaClientSetOperation_AddArrayValueAsFloat (AwaClientSetOperation *operation, const char *path, int resourceInstanceID, AwaFloat value)
AwaError	AwaClientSetOperation_AddArrayValueAsBoolean (AwaClientSetOperation *operation, const char *path, int resourceInstanceID, AwaBoolean value)
AwaError	AwaClientSetOperation_AddArrayValueAsTime (AwaClientSetOperation *operation, const char *path, int resourceInstanceID, AwaTime value)
AwaError	AwaClientSetOperation_AddArrayValueAsOpaque (AwaClientSetOperation *operation, const char *path, int resourceInstanceID, AwaOpaque value)
AwaError	AwaClientSetOperation_AddArrayValueAsObjectLink (AwaClientSetOperation *operation, const char *path, int resourceInstanceID, AwaObjectLink value)

Detailed Description

Adds a path and value to a Set Operation, as a request to change a multiple-instance resource's instance to the specified value.

This allows a Set Operation to modify a single instance of a multiple-instance resource, leaving all other instances unmodified. Only values with the same type as the array resource specified by the path can be added.

Parameters

[in]	operation	The Set Operation to add the path and value to.
[in]	path	The path of the resource requested for change.
[in]	resourceInstanceID	The resource instance ID to change.
[in]	value	The new value of the resource instance.

Returns

AwaError_Success on success.

AwaError_OperationInvalid if the operation is invalid.

AwaError_PathInvalid if the specified path is invalid.

AwaError_TypeMismatch if the specified path refers to a resource with a non-corresponding type.

AwaError_NotDefined if the specified path refers to an object or resource that is not defined.

AwaError_AddInvalid if the specified resource instance ID is outside of the valid range.

Function Documentation

AwaError AwaClientSetOperation_AddArrayValueAsCString	(	AwaClientSetOperation *	operation,
		const char *	path,
		int	resourceInstanceID,
		const char *	value
	)

AwaError AwaClientSetOperation_AddArrayValueAsInteger	(	AwaClientSetOperation *	operation,
		const char *	path,
		int	resourceInstanceID,
		AwaInteger	value
	)

Examples:

client-set-array-example.c.

AwaError AwaClientSetOperation_AddArrayValueAsFloat	(	AwaClientSetOperation *	operation,
		const char *	path,
		int	resourceInstanceID,
		AwaFloat	value
	)

AwaError AwaClientSetOperation_AddArrayValueAsBoolean	(	AwaClientSetOperation *	operation,
		const char *	path,
		int	resourceInstanceID,
		AwaBoolean	value
	)

AwaError AwaClientSetOperation_AddArrayValueAsTime	(	AwaClientSetOperation *	operation,
		const char *	path,
		int	resourceInstanceID,
		AwaTime	value
	)

AwaError AwaClientSetOperation_AddArrayValueAsOpaque	(	AwaClientSetOperation *	operation,
		const char *	path,
		int	resourceInstanceID,
		AwaOpaque	value
	)

AwaError AwaClientSetOperation_AddArrayValueAsObjectLink	(	AwaClientSetOperation *	operation,
		const char *	path,
		int	resourceInstanceID,
		AwaObjectLink	value
	)