Verwalten von Konfigurationseigenschaften

Alle Rückmeldemethoden benötigen Zugriff auf die Konfigurationseigenschaften. Die DSDL unterstützt den Zugriff auf die Eigenschaften folgendermaßen:

• Initialisieren der Umgebung,

• Bereitstellen eines Satzes praktischer Funktionen zum Abrufen von Eigenschaftswerten.

Die scds_initialize-Funktion, die zu Beginn jeder Rückmeldemethode aufgerufen werden muss, führt folgende Aktionen aus:

• Sie prüft und verarbeitet die Befehlszeilenargumente (argc und argv[]), die RGM an die Rückmeldemethode übergibt. Das erspart Ihnen das Schreiben einer Befehlszeilen-Analysefunktion.

• Sie konfiguriert interne Datenstrukturen, die von anderen DSDL-Funktionen verwendet werden können. So speichern zum Beispiel die Funktionen, die Eigenschaftswerte von RGM abrufen, die Werte in diesen Strukturen. Auch Werte aus der Befehlszeile, die Vorrang vor den von RGM abgerufenen Werte haben, werden in den Datenstrukturen gespeichert.

Für die Validate-Methode analysiert scds_initialize die Eigenschaftswerte, die an die Befehlszeile übergeben werden. Damit ersparen Sie sich das Schreiben einer Analysefunktion für Validate.

Die scds_initialize-Funktion initialisiert auch die Protokollierumgebung und validiert die Testsignaleinstellungen des Fehler-Monitors.

Die DSDL stellt Funktionssätze zum Abrufen von Ressourcen-, Ressourcentyp- und Ressourcengruppeneigenschaften sowie von häufig verwendeten Erweiterungseigenschaften bereit. Diese Funktionen wenden folgende Konventionen für den standardmäßigen Zugriff auf Eigenschaften an:

• Jede Funktion übernimmt nur ein Handle-Argument (zurückgegeben von scds_initialize).

• Jede Funktion entspricht einer bestimmten Eigenschaft. Der Rückgabewerttyp der Funktion entspricht dem Typ des abgerufenen Eigenschaftswerts.

• Funktionen geben keine Fehler zurück, da die Werte von scds_initialize vorberechnet wurden. Funktionen rufen Werte von RGM ab, es sei denn, es wird ein neuer Wert an die Befehlszeile übergeben.