F_VN_GetContainer
Gets a pointer to the current element converted into an ITcVnContainer interface and increment its reference counter (only possible for container types). (Alternatively use interface method .GetContainer.)
Syntax
Definition:
FUNCTION F_VN_GetContainer : HRESULT
VAR_INPUT
ipIterator : ITcVnForwardIterator;
ipContainer : Reference To ITcVnContainer;
hrPrev : HRESULT;
END_VAR
Inputs
|
Name |
Type |
Description |
|---|---|---|
|
ipIterator |
Iterator | |
|
ipContainer |
Reference To ITcVnContainer |
Returns the container interface |
|
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
Return valueWeiterführende Informationen
 | Tiefe Kopie Diese Funktion erstellt eine tiefe Kopie des Container-Elements. D. h., wenn Sie das Element im Container verändern wollen, müssen Sie die Änderungen separat in den Container zurückschreiben. |
Wenn Sie gleichzeitig mit dem Zugreifen auf das Container-Element auch den Iterator inkrementieren möchten, steht dafür die Expert-Variante F_VN_GetContainerExp zur Verfügung.
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 |