F_VN_ExportSubContainer

F_VN_ExportSubContainer 1:

Export the container elements of a sub-container into a buffer (e.g. an array). Only possible for 2-dimensional containers with basic elements.

Syntax

Definition:

FUNCTION F_VN_ExportSubContainer : HRESULT
VAR_INPUT
    ipContainer : ITcVnContainer;
    nIndex      : ULINT;
    pBuffer     : PVOID;
    nBufferSize : ULINT;
    hrPrev      : HRESULT;
END_VAR

F_VN_ExportSubContainer 2: Inputs

Name

Type

Description

ipContainer

ITcVnContainer

Container with basic elements

nIndex

ULINT

Index of the requested element

pBuffer

PVOID

Buffer to store the container elements (Make sure to allocate enough memory! The required size in bytes can be determined using the function F_VN_ExportSubContainerSize)

nBufferSize

ULINT

Size of the buffer memory in bytes

hrPrev

HRESULT

HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)

F_VN_ExportSubContainer 3: Return value

HRESULT

Related functions

Required License

TC3 Vision Base

System Requirements