GetContainer (Exp)

Gets a pointer to the current element converted into an ITcVnContainer interface and increment its reference counter (only possible for container types). Additionally, an offset to increment or decrement the iterator afterwards can be provided.

Syntax

Definition:

HRESULT GetContainer(
    HRESULT               hrPrev,
    ITcVnForwardIterator* ipIterator,
    ITcVnContainer*&      ipContainer,
    LONG                  nOffset
)

Parameters

Name	Type	Description
hrPrev	HRESULT	HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.)
ipIterator	ITcVnForwardIterator*	Iterator
ipContainer	ITcVnContainer*&	Returns the container interface
nOffset	LONG	Offset to increment (>0) or decrement (<0) the iterator afterwards

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 PL50, e.g. Intel 4-core Atom CPU	Tc3_Vision