Verwalten von Konfigurationseigenschaften

Alle Rückmeldemethoden setzen den Zugriff auf die Konfigurationseigenschaften voraus. Die DSDL unterstützt den Zugriff auf die Eigenschaften durch Folgendes:

• 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 von RGM an die Rückmeldemethode übergeben werden, so dass Sie keine Befehlszeilen-Parsing-Funktion schreiben müssen.

• 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. Auf ähnliche Weise werden Werte der Befehlszeile, die vor Werten Vorrang haben, die von RGM abgerufen werden, in diesen Datenstrukturen gespeichert.

• Initialisiert die Protokollierungsumgebung und validiert die Testsignaleinstellungen des Fehler-Monitors.

Für die Validate-Methode parst scds_initialize () die Eigenschaftswerte, die in der Befehlszeile übergeben werden, sodass Sie keine Parse-Funktion für Validate schreiben müssen.

Die DSDL bietet Sätze von Funktionen, um Ressourcentyp-, Ressourcen- und Ressourcengruppeneigenschaften sowie häufig verwendete Erweiterungseigenschaften abzurufen. Diese Funktionen standardisieren den Zugriff auf die Eigenschaften unter Berücksichtigung der folgenden Konventionen:

• 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.