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.59 or later

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

Tc3_Vision