clear_templateT_clear_templateClearTemplateClearTemplateclear_template (Operator)
Name
clear_templateT_clear_templateClearTemplateClearTemplateclear_template — Freigabe des Speichers eines Templates.
Warnung
clear_templateclear_templateClearTemplateClearTemplateClearTemplateclear_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
Beschreibung
clear_templateclear_templateClearTemplateClearTemplateClearTemplateclear_template gibt den Speicher eines Templates,
das mit create_templatecreate_templateCreateTemplateCreateTemplateCreateTemplatecreate_template oder create_template_rotcreate_template_rotCreateTemplateRotCreateTemplateRotCreateTemplateRotcreate_template_rot
angelegt wurde, wieder frei.
Das Template kann nach dem Aufruf nicht mehr
verwendet werden. Der Wert von TemplateIDTemplateIDTemplateIDTemplateIDtemplateIDtemplate_id ist
ungültig. Die Nummer kann jedoch bei nachfolgenden
Aufrufen von create_templatecreate_templateCreateTemplateCreateTemplateCreateTemplatecreate_template oder create_template_rotcreate_template_rotCreateTemplateRotCreateTemplateRotCreateTemplateRotcreate_template_rot
wieder vergeben 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.
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.
Parameter
TemplateIDTemplateIDTemplateIDTemplateIDtemplateIDtemplate_id (input_control, Zustand wird modifiziert) template → HTemplate, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Nummer des Templates.
Ergebnis
Ist die Nummer des Templates gültig, dann liefert
clear_templateclear_templateClearTemplateClearTemplateClearTemplateclear_template den Wert 2 (H_MSG_TRUE).
Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Vorgänger
create_templatecreate_templateCreateTemplateCreateTemplateCreateTemplatecreate_template,
create_template_rotcreate_template_rotCreateTemplateRotCreateTemplateRotCreateTemplateRotcreate_template_rot,
read_templateread_templateReadTemplateReadTemplateReadTemplateread_template,
write_templatewrite_templateWriteTemplateWriteTemplateWriteTemplatewrite_template
Modul
Matching