Freigeben über


ValueMap- und Wertqualifizierer

Eine Wertzuordnung ist ein Array, das mit einer Eigenschaft mit dem Value und ValueMap- Qualifizierern verknüpft ist.

Die Eigenschaft fungiert als Index im Array, wobei ein Wert vorhanden ist, der einen der Werte im Array darstellt. Mithilfe von MOF-Code können Sie über die folgenden Typen von Wertzuordnungen verfügen:

  • Arrayzuordnung zu einer ganzen Zahl.

    Sie können ein Array mit dem Value Qualifizierer definieren und das Array direkt mit einer ganzzahligen Eigenschaft verknüpfen, wie im folgenden Beispiel gezeigt:

    [Values {"OK", "Error", "Degraded", "Unknown"}, Read]
    sint32 Status;
    

    In diesem Beispiel ist der wert der Status-Eigenschaft ein Index im Zeichenfolgenarray, das durch Valuedefiniert wird. Die Eigenschaft kann nur Werte übernehmen, die den Ordnungspositionen im Value Array minus 1 entsprechen. Das Festlegen Status auf "1" wird z. B. dem Wert "Error" zugeordnet. Die Indexeigenschaft kann nur Werte annehmen, die Positionen im Value Array entsprechen. Wenn das Array beispielsweise 10 Einträge enthält, kann die Indexeigenschaft 0 bis 9, nicht 30 oder 177.

  • Arrayzuordnung zu einer anderen Arrayzuordnung zu einer ganzen Zahl.

    Wenn Sie einen Index erstellen möchten, der kein Ordnungssystem der Zählung verwendet, verwenden Sie den ValueMap- Qualifizierer. Der ValueMap Qualifizierer richtet ein weiteres Array ein, das ein beliebiges Indexnummerierungssystem enthält, wie im folgenden Beispiel gezeigt:

    [ValueMap {"1", "3", "99", "0"}, 
     Values {"OK", "Error", "Degraded", "Unknown"}, Read]
    sint32 Status;
    

    Obwohl Sie die Werte von ValueMap- in Anführungszeichen platzieren müssen, berücksichtigt WMI die Werte ganze Zahlen. Daher können Sie in diesem Beispiel die eigenschaft Status auf eine ganze Zahl im ValueMap- festlegen: 1, 3, 99 oder 0. WMI ordnet jede ganze Zahl aus einer Ordnungsposition im ValueMap- Zeichenfolgenarray einer entsprechenden Position im Value Array zu. Wenn Sie z. B. Status auf 0 festlegen, wird "Unbekannt" zugeordnet.

  • Arrayzuordnung zu einer anderen Arrayzuordnung zu einer Zeichenfolge.

    Wenn Sie keine ganze Zahl zum Indizieren Des Arrays verwenden möchten, können Sie stattdessen eine Zeichenfolge verwenden, um einen der möglichen Werte in Ihrem Array zu speichern. Dazu müssen Sie sowohl ein Value als auch ValueMap- Array definieren, das beide Zeichenfolgen enthalten, wie im folgenden Beispiel gezeigt:

    [ValueMap {"OK", "Error", "Degraded", "Unknown"}, 
     Values {"OK", "Error", "Degraded", "Unknown"}, Read]
    string Status;
    

    Bei einer Zeichenfolgeneigenschaft sind die tatsächlich zulässigen Werte der Eigenschaft die Einträge im ValueMap Arrays. Sie können z. B. Status auf "OK" oder "Unbekannt" festlegen.

Es liegt an der Anwendung, Die Vorteile von Zuordnungen auf nützliche Weise zu nutzen. Es liegt an dem Anbieter, einen rechtlichen Wertebereich zu erzwingen.

Bemerkungen

Bei der Entscheidung, ob die ValueMap/Value oder BitMap/BitValues Qualifizierer verwendet werden soll, bestimmen Sie, ob gleichzeitig eine der angegebenen Werte auftreten kann. Wenn mehrere gleichzeitige Werte vorhanden sein können, müssen Sie BitMap-/BitValues-verwenden. Wenn sich alle Werte gegenseitig ausschließen, sollten Sie die ValueMap/Value Qualifizierer verwenden.

BitMap- und BitValues-