Udostępnij przez


Standardowe kwalifikatory WMI

Poniżej wymieniono standardowe kwalifikatory specyficzne dla usługi WMI.

Poprawka

Typ danych: wartość logiczna

Dotyczy: klasy

Wskazuje, że klasa zawiera zmienione kwalifikatory, które są zlokalizowane. Wartość domyślna to true.

Skojarzona klasa może zostać przetłumaczona. Aby uzyskać dostęp do przetłumaczonej wersji, użyj identyfikatora ustawień regionalnych, aby utworzyć nazwę przestrzeni nazw.

Bypass_GetObject

Typ danych: wartość logiczna

Dotyczy: metody

Wskazuje, że wywołanie metody powinno zostać przekazane bezpośrednio do wywołania ExecMethodAsync dostawcy, a nie dostawcy, wykonując wywołanie metody GetObject w celu zweryfikowania ścieżki obiektu. Wartość domyślna to FALSE. Korzystanie z Bypass_GetObject może znacznie poprawić wydajność.

Przed użyciem Bypass_GetObject upewnij się, że żadne z następujących akcji nie są wykonywane:

  • Utwórz klasę na podstawie klasy.
  • Zastąpi metodę, która ma kwalifikator Bypass_GetObject .

Brak zastosowania tych środków ostrożności może spowodować wywołanie implementacji metody klasy nadrzędnej zamiast klasy podrzędnej. Aby uzyskać więcej informacji, zobacz Using the Bypass_GetObject Qualifier (Używanie kwalifikatora Bypass_GetObject).

CIM_Key

Typ danych: CIM_BOOLEAN

Dotyczy: właściwości

Wskazuje, że skojarzona właściwość jest właściwością klucza w modelu CIM, ale nie w usłudze WMI.

Typ modelu CIM

Typ danych: VT_BSTR

Dotyczy: właściwości, metody, parametry

Zawiera tekst opisujący typ właściwości.

KlasaContext

Typ danych: VT_BSTR

Dotyczy: klasy

Wskazuje, że klasa ma wystąpienia skojarzone z większą liczbie informacji dynamicznie dostarczanych przez dostawcę.

Przestarzałe

Typ danych: CIM_BOOLEAN

Dotyczy: właściwości, klasy

Wskazuje, że właściwość została zastąpiona przez inną właściwość.

Wyświetlać

Dotyczy: klasy, właściwości

UUID skojarzonej klasy.

Dynamiczny

Typ danych: wartość logiczna

Dotyczy: klasy, właściwości

Wskazuje klasę, której wystąpienia są tworzone dynamicznie. Wartość tego kwalifikatora musi być ustawiona na wartość TRUE.

DynProps

Typ danych: wartość logiczna

Dotyczy: klas, wystąpień

Wskazuje, że wystąpienie zawiera wartości udostępniane przez dostawców właściwości dynamicznych. Wartość domyślna to true.

Należy określić ten kwalifikator w takim wystąpieniu. Dozwolona jest tylko wartość TRUE .

Stały

Typ danych: CIM_BOOLEAN

Dotyczy: wystąpienia

Wskazuje, że wartość tej właściwości nie może ulec zmianie w okresie istnienia wystąpienia.

ID

Typ danych: VT_I4

Dotyczy: właściwości, parametry

Unikatowo identyfikuje i sekwencjonuje właściwość lub parametr metody, gdy instrukcje MOF są generowane automatycznie.

Ten kwalifikator jest wymagany tylko dla parametrów metody. Podczas tworzenia parametrów dla metody projektanci klas powinni rozpoczynać się od identyfikatora (0) dla pierwszego parametru i użyć każdej kolejnej liczby całkowitej dla każdego kolejnego parametru. Jeśli kwalifikatory identyfikatorów zostaną przypadkowo pominięte, kompilator MOF automatycznie generuje kwalifikatory identyfikatorów .

wdrożono

Typ danych: wartość logiczna

Dotyczy: metody

Wskazuje, że metoda ma implementację dostarczoną przez dostawcę.

InstanceContext

Typ danych: VT_BSTR

Dotyczy: wystąpienia

Wskazuje, że wystąpienie zawiera wartości dostarczone przez dostawcę właściwości dynamicznych.

Wartość jest przekazywana do dostawcy właściwości jako argument do metody IWbemPropertyProvider::GetProperty.

ustawień regionalnych

Typ danych: VT_BSTR

Dotyczy: klas lub wystąpień

Określa język pochodzenia dla klasy lub wystąpienia. Aby uzyskać więcej informacji na temat wartości ustawień regionalnych, zobacz Kody ustawień regionalnych.

Przestrzeń nazwZabezpieczeniaSDDL

Typ danych: tablica ciągów

Dotyczy: wystąpienia przestrzeni nazw

Określa deskryptor zabezpieczeń dla przestrzeni nazw w formacie SDDL . Aby uzyskać więcej informacji, zobacz Ustawienie zabezpieczenia przestrzeni nazw podczas tworzenia przestrzeni nazw. Ciąg SDDL jest przetwarzany przez usługę WMI w celu ustanowienia zabezpieczeń przestrzeni nazw, ale nie jest przechowywany jako ciąg. Jeśli nie określono deskryptora zabezpieczeń, zostanie użyte domyślne zabezpieczenia. Aby uzyskać więcej informacji, zobacz Setting Namespace Security Descriptors.

Fakultatywny

Typ danych: wartość logiczna

Dotyczy: parametry

Wskazuje, że parametr nie jest wymagany i że ma dobrze zachowywaną wartość domyślną.

Uprawnienia

Typ danych: tablica ciągów

Dotyczy: właściwości, metody

Zestaw wartości używanych do informowania klienta, które uprawnienia są wymagane do tworzenia wystąpień, wypełniania właściwości lub wykonywania metod. Wartość domyślna to FALSE.

WłaściwośćContext

Typ danych: VT_BSTR

Dotyczy: właściwości

Wskazuje, że właściwość wystąpienia zawiera wartości udostępniane przez dostawców właściwości dynamicznych.

Należy określić ten kwalifikator dla takiej właściwości. Wartość jest przekazywana do dostawcy właściwości jako argumentU do IWbemPropertyProvider::GetProperty.

Dostawca

Typ danych: VT_BSTR

Dotyczy: klasy

Wartość tego kwalifikatora to nazwa dostawcy dynamicznego, który udostępnia wystąpienia klas i odświeża dane wystąpienia. Ta nazwa musi być zarejestrowana w usłudze WMI przez utworzenie wystąpienia klasy __Win32Provider z właściwością Name zawierającą tę nazwę. Gdy ten kwalifikator jest określony w klasie, której wystąpienia są udostępniane dynamicznie, należy również określić kwalifikator dynamiczny .

RequiresEncryption

Typ danych: wartość logiczna

Dotyczy: wystąpienia przestrzeni nazw

Jeśli ustawiono wartość TRUE, ustawienie WymagaEncryption oznacza przestrzeń nazw, aby aplikacje klienckie i skrypty musiały łączyć się z zaszyfrowanym uwierzytelnianiem. Poziom uwierzytelniania musi być ustawiony na RPC_C_AUTHN_LEVEL_PKT_PRIVACY w języku C++. W przypadku skryptów lub Języka Visual Basic poziom uwierzytelniania musi być ustawiony na WbemAuthenticationLevelPrivacy. Aby uzyskać więcej informacji, zobacz Setting Namespace Security Descriptors. Kwalifikator jest używany w moF z pragma przestrzeni nazw preprocesor polecenia.

Aby uzyskać więcej informacji, zobacz Ustawianie domyślnego poziomu zabezpieczeń procesu przy użyciu języka C++ lub Ustawianie domyślnego poziomu zabezpieczeń procesu przy użyciu języka VBScript. Poziomy uwierzytelniania skryptów są definiowane w elembemAuthenticationLevelEnum.

Singleton

Typ danych: wartość logiczna

Dotyczy: klasy

Wyznacza klasę, która może mieć tylko jedno wystąpienie i która nie zawiera właściwości klucza.

Dozwolona jest tylko wartość TRUE (wartość domyślna).

Statyczny

Typ danych: wartość logiczna

Dotyczy: metody

Wskazuje, czy metoda może być wywoływana przy użyciu definicji klasy, czy jej wystąpień.

Nie można wywołać metody z wystąpienia.

Podtypu

Typ danych: VT_BSTR

Dotyczy: właściwości

Wskazuje, że właściwość typu CIM_DATETIME reprezentuje przedział czasu, a nie określony czas.

Aby zidentyfikować właściwość jako interwał, wartość tego kwalifikatora musi być "interwał". Wszystkie inne wartości dla tego kwalifikatora są zarezerwowane do użytku w przyszłości.

Identyfikator UUID

Typ danych: ciągu

Dotyczy: klasy

Uniwersalny unikatowy identyfikator zastosowany do klasy.

ClassVersion

Typ danych: ciągu

Dotyczy: klasy

Numer wersji obiektu klasy. Wartość domyślna to NULL. Numer wersji jest zwiększany po wprowadzeniu zmian w klasie.

WritePrivileges

Typ danych: tablica ciągów

Dotyczy: właściwości

Zestaw wartości wskazujących, które uprawnienia systemowe muszą być dostępne i włączone dla pomyślnej operacji zapisu.

Uwagi

Kody ustawień regionalnych

Kod ustawień regionalnych ma postać "MS_<Three Digit Language ID>". Na przykład ustawienia regionalne w języku angielskim są MS_409. W poniższej tabeli wymieniono identyfikatory języków.

Język Identyfikator języka (szesnastkowy)
Arabski język 401
portugalski (Brazylia) 416
Chiński (uproszczony) 804
Chiński (tradycyjny) 404
Czeski 405
Duński 406
Niderlandzki 413
Angielski (domyślny) 409
Fiński 40b
Francuski 40c
Niemiecki 407
Grecki 408
Hebrajski 40d
Węgierski 40e
Włoski 410
Japoński 411
Koreański 412
Norweski 414
Polski 415
Język portugalski (Portugalia) 816
Rosyjski 419
Hiszpański c0a
Szwedzki 41D
Turecki 41f

Korzystanie z kwalifikatora Bypass_GetObject

Użycie kwalifikatora Bypass_GetObject metody może spowodować mylące wyniki.

W poniższym przykładzie zdefiniowano klasy Shape i Circle . Należy pamiętać, że klasa Circle pochodzi z klasy Shape .

class Shape
{
   string Name;
   uint32 DrawIt();  // - draws an irregular geometric shape
};

class Circle : Shape
{
   uint32 DrawIt();  // - draws a circle
};

Następujące wywołanie metody ExecMethod używa obiektu Circle o nazwie "MyCircle", aby narysować okrąg.

ExecMethod("Shape.Name='MyCircle'","DrawIt");

W poprzednim scenariuszu usługa WMI wywołuje metodę GetObject; odnajduje, że "Shape.Name='MyCircle"" jest okręgiem; i wykonuje implementację CircledrawIt. Jeśli jednak używasz kwalifikatora Bypass_GetObject w metodzie DrawIt, usługa WMI nie wywołuje obiektu GetObject, nie odnajduje, że element "Shape.Name='MyCircle" jest okręgiem i wykonuje implementację shapeelementu DrawItzamiast implementacji Circle drawIt.

Następujące wywołanie metody ExecMethod zawsze wywołuje poprawną implementację metody DrawIt.

ExecMethod("Circle.Name='MyCircle'","DrawIt");

Wymagania

Wymaganie Wartość
Minimalny obsługiwany klient
Windows Vista
Minimalny obsługiwany serwer
Windows Server 2008

Zobacz także

konfigurowanie deskryptorów zabezpieczeń przestrzeni nazw

kwalifikatory WMI

dodawanie kwalifikatora