REFERENCES OF-Anweisung

Die REFERENCES OF-Anweisung ruft alle Zuordnungsinstanzen ab, die auf eine bestimmte Quellinstanz verweisen. Die REFERENCES OF-Anweisung ähnelt der ASSOCIATORS OF-Anweisung in ihrer Syntax. Anstatt jedoch Endpunktinstanzen abzurufen, ruft sie die dazwischen liegenden Zuordnungsinstanzen ab.

Die REFERENCES OF WHERE-Klausel kann ein oder mehrere der folgenden vordefinierten Schlüsselwörter und deren Werte enthalten:

REFERENCES OF {SourceObject} WHERE 
    ClassDefsOnly
    RequiredQualifier = QualifierName
    ResultClass = ClassName
    Role = PropertyName

Verwenden Sie zum Angeben eines Quellobjekts einen beliebigen gültigen Objektpfad für SourceObject. Wie bei der SELECT-Anweisung ist die WHERE-Klausel optional und wird verwendet, um die Abfrage weiter zu definieren. Das heißt, die folgende Aussage ist perfekt gültig:

REFERENCES OF {Adapter="AHA-294X"}

Das schlüsselwort ClassDefsOnly gibt an, dass die Anweisung ein Resultset von Klassendefinitionsobjekten und nicht tatsächlichen Instanzen der Zuordnungsklassen zurückgibt. Diese Objekte enthalten Definitionen von Klassen, zu denen die Instanzen, die auf das Quellobjekt verweisen, gehören. Die folgende Anweisung gibt beispielsweise Definitionen für die AdapterDriver- und AdapterProtocol Klassen zurück:

REFERENCES OF {Adapter="AHA-294X"} WHERE ClassDefsOnly

Das schlüsselwort RequiredQualifier gibt an, dass die zurückgegebenen Zuordnungsobjekte den angegebenen Qualifizierer enthalten müssen. Das schlüsselwort RequiredQualifier kann verwendet werden, um bestimmte Instanzen von Zuordnungen in das Resultset einzuschließen. Die folgende Anweisung gibt beispielsweise Zuordnungsinstanzen zurück, die einen Qualifizierer AdapterTag-enthalten:

REFERENCES OF {Adapter="AHA-294X"}  WHERE RequiredQualifier = AdapterTag

Das ResultClass Schlüsselwort gibt an, dass die zurückgegebenen Zuordnungsobjekte zu der angegebenen Klasse gehören oder von dieser abgeleitet werden müssen. Die folgende Anweisung gibt beispielsweise Zuordnungen der AdapterDriver Klasse oder Unterklassen AdapterDriver-zurück:

REFERENCES OF {Adapter="AHA-294X"} WHERE ResultClass = AdapterDriver

Die schlüsselwörter ClassDefsOnly und ResultClass schließen sich gegenseitig aus. Die Gemeinsame Verwendung führt zu einem ungültigen Abfragefehler.

Das schlüsselwort Role gibt an, dass die zurückgegebenen Zuordnungen nur diejenigen sind, in denen das Quellobjekt eine bestimmte Rolle spielt. Die Rolle wird durch die angegebene Eigenschaft definiert, eine Referenzeigenschaft vom Typ Bezug. Das schlüsselwort "Role" ist in Zuordnungen nützlich, in denen ein bestimmtes Objekt in einigen Fällen eine Rolle spielen kann, und eine andere Rolle in anderen, z. B. in hierarchischen Zuordnungen. Das schlüsselwort Role kann verwendet werden, um alle Zuordnungen abzurufen, in denen das Quellobjekt beispielsweise die Rolle des übergeordneten Elements spielt. Die folgende Anweisung veranschaulicht die Syntax zum Abrufen von Zuordnungen mit einer übergeordneten Eigenschaft, die auf das Quellobjekt als übergeordnetes Objekt verweist:

REFERENCES OF {Adapter="AHA-294X"} WHERE Role = parent

"REFERENCES OF {Win32_NetworkAdapter.DeviceID="0"} " +
    "WHERE resultclass = Win32_NetworkAdapterSetting " +
    "requiredQualifier = Dynamic"

"REFERENCES OF {Win32_NetworkAdapter.DeviceID="0"} " +
    "WHERE resultclass = Win32_NetworkAdapterSetting " +
    "requiredQualifier <> Dynamic"

"REFERENCES OF {Win32_NetworkAdapter.DeviceID="0"} " +
"WHERE resultclass = Win32_NetworkAdapterSetting " +
"AND requiredQualifier = Dynamic"