Topic       : TOS - das Betriebssystem
Author      : 
Version     : tos.hyp (5. März 2013)
Subject     : Programmieren/Atari
Nodes       : 3001
Index Size  : 93602
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Titel
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File8.3.13  appl_write                                                 TOS

 Name:         »Application write« - sendet eine Mitteilung an eine 
               andere Applikation.

 AES-Nummer:   12

 Deklaration:  int16_t appl_write ( int16_t ap_wid, int16_t 
               ap_wlength, void *ap_wpbuff );

 Beschreibung: Die Funktion schreibt eine Anzahl von Bytes in eine 
               Message-Pipe. Es gilt:

                Parameter  Bedeutung

                ap_wid     ID der Applikation, zu der die Nachricht 
                           geschickt werden soll
                ap_wlength Anzahl der zu sendenden Bytes
                ap_wpbuff  Adresse des Puffers mit der zu 
                           übertragenden Nachricht

               Hinweis: Durch diese Funktion besitzt eine Applikation 
               auch die Möglichkeit, sich selbst eine Redraw-Nachricht 
               zukommen zu lassen. Ab MagiC Version 4.0 gilt: besitzt 
               der Parameter ap_wid den Wert -2, so zeigt ap_wpbuff 
               auf eine XAESMSG-Struktur.

 Ergebnis:     Wird eine Null zurückgegeben, so ist ein Fehler 
               aufgetreten, sonst wird eine positive Zahl als Ergebnis 
               zurückgegeben.

 Verfügbar:    All AES versions.

 Gruppe:       Applikationen

 Querverweis:  Binding   appl_init   appl_read   appl_find 
               Nachrichten