ODWOŁANIA DO instrukcji

Instrukcja REFERENCES OF pobiera wszystkie wystąpienia skojarzeń odwołujące się do określonego wystąpienia źródłowego. Instrukcja REFERENCES OF jest podobna do instrukcji ASSOCIATORS OF w jego składni. Jednak zamiast pobierać wystąpienia punktu końcowego, pobiera interweniujące wystąpienia skojarzeń.

Klauzula REFERENCES OF WHERE może zawierać co najmniej jedno z następujących wstępnie zdefiniowanych słów kluczowych i ich wartości:

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

Aby określić obiekt źródłowy, użyj dowolnej prawidłowej ścieżki obiektu dla obiektu SourceObject. Podobnie jak w przypadku instrukcji SELECT, klauzula WHERE jest opcjonalna i służy do dalszego definiowania zapytania. Oznacza to, że następujące stwierdzenie jest całkowicie prawidłowe:

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

Słowo kluczowe ClassDefsOnly wskazuje, że instrukcja zwraca zestaw wyników obiektów definicji klas zamiast rzeczywistych wystąpień klas klas. Te obiekty zawierają definicje klas, do których należą wystąpienia odwołujące się do obiektu źródłowego. Na przykład następująca instrukcja zwraca definicje dla klas AdapterDriver i AdapterProtocol AdapterProtocol:

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

RequiredQualifier słowo kluczowe wskazuje, że zwrócone obiekty skojarzenia muszą zawierać określony kwalifikator. Słowo kluczowe RequiredQualifier może służyć do uwzględnienia określonych wystąpień skojarzeń w zestawie wyników. Na przykład następująca instrukcja zwraca wystąpienia skojarzeń zawierające kwalifikator o nazwie AdapterTag:

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

Słowo kluczowe ResultClass wskazuje, że zwrócone obiekty skojarzenia muszą należeć do określonej klasy lub pochodzić z określonej klasy. Na przykład następująca instrukcja zwraca skojarzenia AdapterDriver klasy lub podklasy AdapterDriver:

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

Słowa kluczowe ClassDefsOnly i ResultClass wzajemnie się wykluczają. Użycie ich razem powoduje błąd nieprawidłowego zapytania.

Słowo kluczowe Rola wskazuje, że zwracane skojarzenia są tylko tymi, w których obiekt źródłowy odgrywa określoną rolę. Rola jest definiowana przez określoną właściwość , właściwość odwołania typu ref. Słowo kluczowe rola jest przydatne w skojarzeniach, w których określony obiekt może odgrywać jedną rolę w niektórych przypadkach i inną rolę w innych, takich jak w skojarzeniach hierarchicznych. Słowo kluczowe roli może służyć do pobierania wszystkich skojarzeń, w których obiekt źródłowy odgrywa na przykład rolę nadrzędną. Poniższa instrukcja ilustruje składnię pobierania skojarzeń, które mają właściwość nadrzędną odwołującą się do obiektu źródłowego jako obiektu nadrzędnego:

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

Nuta

Złożone zapytania nie mogą używać instrukcji "And" lub "Or", aby oddzielić słowa kluczowe dla ASSOCIATORS OF i REFERENCES OF. Ponadto znak równości jest jedynym prawidłowym operatorem, który może być używany ze słowami kluczowymi w tych zapytaniach. Na przykład następujące zapytanie jest prawidłowe:

 

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

Nuta

Następne przykłady są nieprawidłowe. Pierwszy przykład nie używa znaku równości, a drugi przykład błędnie próbuje użyć słowa kluczowego AND:

 

"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"