NAME

xdas_release_buffer - free storage associated with a buffer

SYNOPSIS

OM_uint32 xdas_release_buffer(
    OM_uint32	 			*minor_status,
    const xdas_audit_ref_t		*das_ref,
    xdas_buffer_t			*buffer
);

DESCRIPTION

xdas_release_buffer() is a member of the Basic XDAS Conformance class. The xdas_release_buffer() function frees storage associated with a buffer. The storage must have been allocated by an XDAS-API function. In addition to freeing the associated storage, the function zeros the length field in the buffer argument. If successful, the function returns [XDAS_S_COMPLETE]. The arguments for xdas_release_buffer() are:

minor_status (out)

An implementation specific return status that provides additional information when [XDAS_S_FAILURE] is returned by the function.

das_ref (in)

Handle to the XDAS service obtained by a previous call to xdas_initialize_session().

buffer (in,out)

The storage associated with the buffer is deleted. The xdas_buffer_t object is not freed, but its length field is zeroed.

RETURN VALUE

The following XDAS status codes shall be returned:

[XDAS_S_COMPLETE]

Successful completion.

[XDAS_S_FAILURE]

An implementation specific error or failure has occurred.

[XDAS_S_INVALID_DAS_REF]

The audit service handle supplied is invalid.

ERRORS

No other errors are defined.

[??] Some characters or strings that appear in the printed document are not easily representable using HTML.