clear_message_queue
— Schließen einer Warteschlange für Nachrichten.
clear_message_queue( : : QueueHandle : )
clear_message_queue
schließt ein Warteschlangenobjekt
QueueHandle
, dass zuvor durch den Operator
create_message_queue
erzeugt wurde.
Es werden alle Ressourcen freigegeben, die von der Warteschlange
gehalten werden, einschließlich der eingereihten Nachrichtenobjekte
und der in ihnen enthaltenen Datensätze.
Nachdem die Warteschlangenobjekte durch clear_message_queue
zerstört wurden
dürfen sie nicht mehr verwendet werden. Die Verwendung von
ungültigen Referenzen führt zu undefiniertem Verhalten. Der Operator
clear_message_queue
darf nicht auf ein Warteschlangenobjekt
aufgerufen werden, dass gleichzeitig noch in einem anderen Thread in
Verwendung ist. Dies führt zu undefiniertem Verhalten.
Dieser Operator modifiziert den Zustand des folgenden Eingabeparameters:
Während der Ausführung dieses Operators muss der Zugriff auf den Wert dieses Parameters synchronisiert werden, wenn er über mehrere Threads hinweg verwendet wird.
QueueHandle
(input_control, Zustand wird modifiziert) message_queue(-array) →
(handle)
Freizugebene Warteschlangenobjekt(e).
Parameteranzahl: QueueHandle >= 1
Restriktion: QueueHandle != 0
create_message_queue (ProducerQueue) create_message_queue (ResultQueue) * ...
clear_message_queue
gibt den Wert 2 (H_MSG_TRUE) zurück, wenn die
übergebenen Warteschlangenobjekte gültig sind. Andernfalls wird eine
Fehlerbehandlung durchgeführt. Sollte eine der übergebenen
Referenzen ungültig sein, wird clear_message_queue
dennoch
versuchen alle anderen Referenzen freizugeben bevor es den Fehler
zurück gibt.
create_message_queue
,
set_message_queue_param
create_message_queue
,
enqueue_message
,
dequeue_message
,
set_message_queue_param
,
get_message_queue_param
,
create_message
,
clear_message
,
set_message_tuple
,
get_message_tuple
,
set_message_obj
,
get_message_obj
Foundation