LabWindows/CVI

CVIXMLGetAttributeNameLength

CVIXMLStatus CVIXMLGetAttributeNameLength (CVIXMLAttribute attribute, int *length);

Purpose

Gets the length of the name of an attribute. You can use this function to allocate memory before getting the name of the attribute.

Parameters

Input
Name Type Description
attribute CVIXMLAttribute The attribute handle must be a valid CVIXMLAttribute.
Output
Name Type Description
length int On output, contains the length of the attribute's name in bytes. The length does not include the terminating NUL-byte.

Return Value

Name Type Description
status CVIXMLStatus Indicates whether the function was successful.

A zero indicates success.

You can call CVIXMLGetErrorString to obtain textual descriptions of error codes. Among the more commonly encountered errors are:

E_OUTOFMEMORY Out of memory.
E_INVALIDARG Invalid argument to a function.

Additional Information

Library: CVIXML

Include file: toolbox\cvixml.h

LabWindows/CVI compatibility: LabWindows/CVI 7.0 and later

Example

Refer to toolbox\XMLSample.cws for an example of using the CVIXMLGetAttributeNameLength function.