serialize_templateT_serialize_templateSerializeTemplateSerializeTemplateserialize_template (Operator)
Name
serialize_templateT_serialize_templateSerializeTemplateSerializeTemplateserialize_template — Serialisieren eines Templates.
Warnung
serialize_templateserialize_templateSerializeTemplateSerializeTemplateserialize_template ist veraltet und wird nur aus Gründen
der Rückwärtskompatibilität zur Verfügung gestellt. Neue
Applikationen sollten stattdessen die
Form-basierten oder NCC-basierten Operatoren verwenden.
Signatur
def serialize_template(template_id: HHandle) -> HHandle
Beschreibung
serialize_templateserialize_templateSerializeTemplateSerializeTemplateserialize_template serialisiert die Daten eines
Templates (siehe fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item für eine Einführung
in die Grundlagen der Serialisierung).
Dabei werden dieselben Daten in ein serialisiertes Element überführt,
die von write_templatewrite_templateWriteTemplateWriteTemplatewrite_template in eine Datei geschrieben werden.
Das Template wird in dem Handle TemplateIDTemplateIDTemplateIDtemplateIDtemplate_id übergeben.
Das serialisierte Template wird in dem Handle
SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle zurückgegeben und kann mit
deserialize_templatedeserialize_templateDeserializeTemplateDeserializeTemplatedeserialize_template wieder deserialisiert werden.
Ausführungsinformationen
- Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
TemplateIDTemplateIDTemplateIDtemplateIDtemplate_id (input_control) template → HTemplate, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des OCV-Tools.
SerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (output_control) serialized_item → HSerializedItem, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des serialisierten Templates.
Ergebnis
Sind die Parameterwerte korrekt, dann liefert
serialize_templateserialize_templateSerializeTemplateSerializeTemplateserialize_template den Wert 2 (
H_MSG_TRUE)
.
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Vorgänger
create_templatecreate_templateCreateTemplateCreateTemplatecreate_template,
create_template_rotcreate_template_rotCreateTemplateRotCreateTemplateRotcreate_template_rot
Nachfolger
fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item,
send_serialized_itemsend_serialized_itemSendSerializedItemSendSerializedItemsend_serialized_item,
deserialize_templatedeserialize_templateDeserializeTemplateDeserializeTemplatedeserialize_template
Modul
Matching