DSSetHandleSize (LabVIEW Manager Function)

LabVIEW 2018 Help


Edition Date: March 2018
Part Number: 371361R-01
View Product Info

DOWNLOAD (Windows Only)


LabVIEW 2016 Help
LabVIEW 2017 Help
LabVIEW 2018 Help
LabVIEW 2019 Help
LabVIEW 2020 Help

MgErr DSSetHandleSize(h, size);

Purpose

Changes the size of the block of memory referenced by the specified handle.

To use this function to resize an array handle, you must calculate how many bytes the resized array requires. Many platforms have memory alignment requirements that make it difficult to determine the correct size for the resulting array. Learn about how LabVIEW stores data in memory to calculate the size and alignment of array elements, especially for arbitrary data types such as clusters.

To resize a handle for a numeric array, use the NumericArrayResize manager function instead of DSSetHandleSize.

Do not use this function on a locked handle.

Parameters

Name Type Description
h UHandle Handle you want to resize.
size size_t New size, in bytes, of the handle.

Return Value

MgErr, which can contain the following errors. If you receive errors from LabVIEW Manager functions, most error names correspond to LabVIEW error codes.

Value Corresponding Error Code or Description
noErrNo error.
mZoneErrHandle or pointer not in specified zone.
mFullErr2

WAS THIS ARTICLE HELPFUL?

Not Helpful