ExportContainer_String

Export the container elements into a string. Only possible for containers of type ContainerType_String_SINT.

Syntax

Definition:

HRESULT ExportContainer_String(
    HRESULT         hrPrev,
    ITcVnContainer* ipContainer,
    PCHAR           sText,
    ULONGLONG       nMaxLength
)

Parameters

Name

Type

Description

hrPrev

HRESULT

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

ipContainer

ITcVnContainer*

Container of type ContainerType_String_SINT

sText

PCHAR

Make sure to choose a sufficient STRING size! The required size can be determined using the function VnExportContainerSize.

nMaxLength

ULONGLONG

Maximum string length to export (including 0 termination). If the container content is longer, the string is cut off at nMaxLength - 1 and 0 termination is appended. In this case, S_FALSE is returned.

ExportContainer_String 1: Return value

HRESULT

Required License

TC3 Vision Base

System Requirements

Development environment

Target platform

PLC libraries to include

TwinCAT V3.1.4024.54 or later

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

Tc3_Vision