AwaServerDiscoverResponse_GetAttributeValueAs___Pointer

Retrieve a temporary pointer to an object, object instance or resource attribute's value from a Discover Response. More...

Functions
AwaError	AwaServerDiscoverResponse_GetAttributeValueAsIntegerPointer (const AwaServerDiscoverResponse *response, const char *path, const char *link, const AwaInteger **value)
AwaError	AwaServerDiscoverResponse_GetAttributeValueAsFloatPointer (const AwaServerDiscoverResponse *response, const char *path, const char *link, const AwaFloat **value)

Detailed Description

Retrieve a temporary pointer to an object, object instance or resource attribute's value from a Discover Response.

This function can only be successful after a Discover operation has been successfully processed. The pointer is only valid while the operation is valid. If the operation is freed, the pointer returned is immediately invalid and should not be used or dereferenced.

Parameters

[in]	response	The current Discover Response to retrieve the value from.
[in]	path	The path of the resource requested for retrieval.
[in]	link	The link identifying which attribute value to be retrieved (currently limited to "pmin", "pmax", "gt", "lt", and "stp").
[in,out]	value	A pointer to a const pointer that will be modified to point to the requested value.

Returns

AwaError_Success on success.

AwaError_TypeMismatch if the resource type corresponding to the specified path is not of the correct type.

AwaError_PathNotFound if the specified resource path is not covered by the Discover Response.

AwaError_OperationInvalid if the specified operation is invalid or NULL.

AwaError_PathInvalid if the specified path is invalid or does not correspond to a resource path.

Function Documentation

AwaError AwaServerDiscoverResponse_GetAttributeValueAsIntegerPointer	(	const AwaServerDiscoverResponse *	response,
		const char *	path,
		const char *	link,
		const AwaInteger **	value
	)

AwaError AwaServerDiscoverResponse_GetAttributeValueAsFloatPointer	(	const AwaServerDiscoverResponse *	response,
		const char *	path,
		const char *	link,
		const AwaFloat **	value
	)