EricTransferHandle

Type Alias EricTransferHandle 

Source
pub type EricTransferHandle = u32;
Expand description

@brief Das ::EricTransferHandle wird beim Anwendungsfall “Datenabholung” der API-Funktion ::EricBearbeiteVorgang() übergeben.

Es ist vom Aufrufer zu initialisieren und wird ::EricBearbeiteVorgang() als Zeiger übergeben. Es wird verwendet, um bei der Datenabholung mehrere Versandvorgänge zu bündeln. Dabei ist das Handle für den ersten Vorgang “Anfrage” mit dem Wert 0 zu initialisieren, bevor ::EricBearbeiteVorgang() aufgerufen wird. Das von ::EricBearbeiteVorgang() zurückgegebene Handle ist dann bei allen Folgevorgängen derselben Datenabholung unverändert wieder zu übergeben.

Wird bei einer Datenabholung NULL oder ein ungültiger Zeiger als Handle übergeben, gibt ::EricBearbeiteVorgang() den Fehlercode ::ERIC_GLOBAL_TRANSFERHANDLE zurück.

Bei allen Verfahren außer der Datenabholung sollte das Transferhandle beim Aufruf der ::EricBearbeiteVorgang() NULL sein. Wird bei solchen Verfahren ein Handle übergeben, so wird dieses ignoriert.