F_VN_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:
FUNCTION F_VN_CreateContainerFromArray : HRESULT
VAR_INPUT
pData : PVOID;
ipContainer : Reference To ITcVnContainer;
nTypeGuid : GUID;
nElementNum : ULINT;
hrPrev : HRESULT;
END_VAR
Inputs
|
Name |
Type |
Description |
|---|---|---|
|
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 |
Reference To ITcVnContainer |
Returns the created container |
|
nTypeGuid |
GUID |
Type GUID of the container to be created |
|
nElementNum |
ULINT |
Number of elements to copy from pData |
|
hrPrev |
HRESULT indicating the result of previous operations (If SUCCEEDED(hrPrev) equals false, no operation is executed.) |
Return valueWeiterführende Informationen
Zur Festlegung des Container-Typs über den Parameter nTypeGuid können die globalen ContainerType-Konstanten verwendet werden.
Da die Daten des Arrays nur über einen Pointer angegeben werden, ist eine Typüberprüfung innerhalb der Funktion nicht möglich. Beachten Sie daher folgende Warnung:
| |
Speicherzugriff Es muss sichergestellt sein, dass der Typ und Länge des Containers mit der Größe des Speicherbereichs am Pointer übereinstimmen. Anderenfalls kann dies zu einem Systemabsturz oder invaliden Daten führen. |
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 |