clear_serialized_item
— Löschen eines serialisierten Elements.
clear_serialized_item( : : SerializedItemHandle : )
clear_serialized_item
löscht ein serialisiertes Element,
welches in dem Handle SerializedItemHandle
übergeben wird
(siehe fwrite_serialized_item
für eine Einführung in die
Grundlagen der Serialisierung).
Nicht gelöscht wird ein serialisiertes Element, welches nur mittels
eines Datenzeigers angelegt wurde. Erzeugt wird ein solcher Datenzeiger,
der auf den Anfang eines serialisierten Elements zeigt, mit
dem Operator get_serialized_item_ptr
. Nach dem Aufruf
ist das Handle des serialisierte Elements ungültig.
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.
SerializedItemHandle
(input_control, Zustand wird modifiziert) serialized_item(-array) →
(handle)
Handle des serialisierten Elements.
Sind die Parameterwerte korrekt, dann liefert
clear_serialized_item
den Wert 2 (H_MSG_TRUE).
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
fwrite_serialized_item
,
receive_serialized_item
Foundation