Type Alias eric_bindings::EricInstanzHandle
source · pub type EricInstanzHandle = *mut EricInstanz;Expand description
@brief Handle auf eine ERiC-Instanz.
ERiC-Instanzen werden von der Multithreading-API angelegt, verwendet und wieder freigegeben, siehe ericmtapi.h. \n Alle API-Funktionen der Multithreading-API nehmen einen Zeiger auf eine ERiC-Instanz entgegen und verrichten ihre Aufgaben auf dieser ERiC-Instanz. Die EricInstanz enthält sämtliche veränderlichen Zustände des ERiC. Dies sind ERiC-Einstellungen, Plugin- und Log-Verzeichnis, Proxyeinstellungen, Zertifikatshandle, Rückgabepuffer, etc. \n Es können mehrere ERiC-Instanzen parallel angelegt werden. Jede dieser ERiC-Instanzen ist unabhängig von allen anderen ERiC-Instanzen. Verfügen mehrere Threads jeweils über ihre eigene ERiC-Instanz, können sie diese parallel verwenden. Dazu müssen die Threads den API-Funktionen der Multithreading-API ihre jeweils eigene ERiC-Instanz übergeben. \n ERiC-Instanzen sollen nicht für jede Aufgabe neu erstellt und konfiguriert werden. Das Erstellen und Zerstören einer ERiC-Instanz ist ressourcen- und zeitintensiv. Die Lebenszeit einer ERiC-Instanz sollte beispielsweise eher der Lebenszeit eines Arbeiter-Threads in einem Pool entsprechen, als der Verarbeitungsdauer einer einzelnen Aufgabe an einen Arbeiter-Thread. \n ERiC-Instanzen können zwischen Threads ausgetauscht werden. Eine ERiC-Instanz darf aber nicht in zwei Threads gleichzeitig verwendet werden.
@see - ::EricMtInstanzErzeugen() - ::EricMtInstanzFreigeben()