CreateContainerFromArray

Creates a container with type GUID nTypeGuid, initialize it with provided data and return its container interface. Only supported for basic container types, i.e. not for containers of containers.

Syntax

Definition:

HRESULT CreateContainerFromArray(
    HRESULT          hrPrev,
    PVOID            pData,
    ITcVnContainer*& ipContainer,
    GUID             nTypeGuid,
    ULONGLONG        nElementNum
)

Parameters

Name

Type

Description

hrPrev

HRESULT

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

pData

PVOID

Pointer to the data array. Make sure that the array contains at least nElementNum elements and that the array element type matches the container element type.

ipContainer

ITcVnContainer*&

Returns the created container

nTypeGuid

GUID

Type GUID of the container to be created

nElementNum

ULONGLONG

Number of elements to copy from pData

CreateContainerFromArray 1: Return value

HRESULT

Required License

TC3 Vision Base

System Requirements

Development environment

Target platform

PLC libraries to include

TwinCAT V3.1. 4024.44 or later

PC or CX (x64) with PL50, e.g. Intel 4-core Atom CPU

Tc3_Vision