F_CreateLinkedListHnd

The function initializes the Linked List Handle. The List Handle must be initialized once by calling the F_CreateLinkedListHnd function.

FUNCTION F_CreateLinkedListHnd: BOOL

VAR_INPUT

VAR_INPUT
    pEntries  : POINTER TO T_LinkedListEntry := 0;
    cbEntries : UDINT := 0;
END_VAR

pEntries: The address of the first T_LinkedListEntry array element. The address can be determined with the ADR operator (type: T_LinkedListEntry).

cbEntries: The size of the T_LinkedListEntry array in bytes. The byte size can be determined with the SIZEOF operator.

VAR_IN_OUT

VAR_IN_OUT
    hList  : T_HLINKEDLIST;
END_VAR

hList: Hash table handle to be initialized (type: T_HLINKEDLIST). The handle is required for accessing the list from the function block FB_LinkedListCtrl.

Return parameter	Description
TRUE	No error
FALSE	Error

Example:

See: Example: Linked list (FB_LinkedListCtrl).

Requirements

Development environment	Target platform	PLC libraries to be integrated (category group)
TwinCAT v3.1.0	PC or CX (x86, x64, ARM)	Tc2_Utilities (System)