Responses
[Common Library Functions and Constants]

Functions
xacml_result_t	xacml_response_get_obligation (const xacml_response_t response, size_t num, xacml_obligation_t *obligation)

---

Function Documentation

xacml_result_t xacml_response_get_obligation	(	const xacml_response_t	response,
		size_t	num,
		xacml_obligation_t *	obligation
	)

Get the value of an obligation

Retrieves the obligation based on the its index. The total number of subject obligations can be determined by calling xacml_response_get_obligation_count().

Parameters:

	response	The response to inspect.
	num	Obligation index.
	obligation	Pointer to be set to the obligation. The caller must not modify or free this value.

Return values:

	XACML_RESULT_SUCCESS	Success.
	XACML_RESULT_INVALID_PARAMETER	Invalid parameter.

See also:

xacml_response_add_obligation(), xacml_response_get_obligation_count()

References XACML_RESULT_INVALID_PARAMETER, and XACML_RESULT_SUCCESS.