Kwalifikatory kontekstu programu Configuration Manager

Obiekty kontekstu są używane w programie Configuration Manager w celu dostarczenia dostawcy SMS dodatkowych informacji. Zazwyczaj kwalifikatory kontekstu służą do przekazywania dostawcy SMS informacji kontekstowych, takich jak nazwa aplikacji. Kwalifikatorów kontekstu można używać podczas nawiązywania połączenia z dostawcą SMS oraz z pojedynczymi obiektami dostawców wiadomości SMS.

Kod zarządzany

W przypadku korzystania z zarządzanych bibliotek dostawców wiadomości SMS należy użyć właściwości ConnectionManagerBase.Context do określenia kwalifikatorów kontekstu. Aby uzyskać więcej informacji, zobacz Jak dodać kwalifikator kontekstu programu Configuration Manager przy użyciu kodu zarządzanego.

Język VBScript

W przypadku korzystania z języka VBScript używany jest zestaw interfejsów SWBemNamedValue do określania kwalifikatorów kontekstu jako kolekcji nazwanych obiektów wartości. Aby uzyskać więcej informacji, zobacz Jak dodać kwalifikator kontekstu programu Configuration Manager przy użyciu usługi WMI.

Kwalifikatory kontekstowe

Poniższa tabela zawiera kwalifikatory kontekstu (nazwane wartości) używane przez dostawcę usługi SMS. Większość kwalifikatorów, takich jak SessionHandle, są używane tylko z określonymi obszarami funkcjonalnymi dostawcy wiadomości SMS, ale LocaleID, MachineName, i ApplicationName są przeznaczone do użytku w Twojej aplikacji.

ApplicationName (Nazwa aplikacji)

Kwalifikator ApplicationName kontekstu jest wartością ciągu, która identyfikuje nazwę aplikacji, która wykonała wywołanie. Należy określić ApplicationName dla swojej aplikacji, ponieważ jest ona używana do inspekcji. Jeśli nazwa aplikacji nie zostanie podana, zostanie użyta wartość Unknown (Nieznane). Musisz podać tę ApplicationName wartość podczas wywoływania dowolnej z metod podnoszenia komunikatu o stanie, takich jak SMS_StatusMessage::RaiseErrorStatusMsg, w przeciwnym razie wywołanie zakończy się niepowodzeniem.

ContextHandle (Uchwyt kontekstowy)

Kwalifikator ContextHandle kontekstu jest wartością ciągu, która określa, gdzie dostawca SMS przechowywał buforowane kwalifikatory kontekstu. Zarządzany dostawca usług SMS zarządza transferem danych. W przypadku korzystania z języka VBScript możesz wykonać następujące kroki, aby zmniejszyć ilość danych przesyłanych przez sieć.

1. Utwórz zestaw wartości SWBemNamedValue .

2. Dodaj kwalifikatory do obiektu kontekstu. Aby uzyskać więcej informacji, zobacz Jak dodać kwalifikator kontekstu programu Configuration Manager przy użyciu usługi WMI.

3. Wywołaj metodę GetContextHandle , aby buforować kwalifikatory na serwerze. Dostawca SMS buforuje obiekt kontekstu przekazywany jako parametr ExecMethod po wywołaniu metody GetContextHandle.

4. Usuń wszystkie kwalifikatory z obiektu kontekstu.

5. ContextHandle Dodaj kwalifikator i wartość do obiektu kontekstu.

6. Przekazuj obiekt kontekstu we wszystkich wywołaniach do usługi IWbemServices.

   Przed zakończeniem aplikacji należy wywołać metodę ClearContextHandle , aby usunąć buforowane kwalifikatory. Możesz utworzyć dowolną liczbę ContextHandle wartości, z których każda dostarcza różnych informacji dla Twojej aplikacji.

Liczba wystąpień

Kwalifikator InstanceCount kontekstu jest wartością całkowitą, która służy do ograniczania liczby wystąpień zwracanych przez metody ExecQuery i CreateInstanceEnum . Ustawiono InstanceCount maksymalną liczbę wystąpień, które mają zostać zwrócone przez zapytanie lub moduł wyliczający. Na przykład ustawienie InstanceCount wartości 10 zwraca co najwyżej 10 wystąpień.

LimitToCollectionIDs

Kwalifikator LimitToCollectionIDs kontekstu jest tablicą ciągów CollectionID zawierającą listę wartości. Obecnie można określić tylko jedną CollectionID wartość. Ten kwalifikator służy do ograniczania wyników zapytania o zasoby do elementów członkowskich nazwanej kolekcji. Zapytanie o zasoby to zapytanie zawierające klasy pochodzące z SMS_Resource lub SMS_Group.

Użytkownik musi mieć uprawnienia do odczytu wystąpienia zasobu dla kolekcji, do której należy zasób. Należy użyć ograniczenia kolekcji, gdy użytkownik nie ma praw do zasobów odczytu klas dla kolekcji; W przeciwnym razie nie są zwracane żadne dane. W przypadku programu SMS 2.0 z dodatkiem Service Pack 1 i nowszych wersji to ograniczenie dotyczy tylko klas pochodzących z SMS_Group.

Nie można użyć tego kwalifikatora podczas wykonywania zapytań dotyczących kolekcji.

Identyfikator ustawień regionalnych

Kwalifikator LocaleID kontekstu jest wartością ciągu, która akceptuje wartość szesnastkową lub dziesiętną w postaci MS\x, gdzie x jest identyfikatorem ustawień regionalnych. Na przykład można wprowadzić wartość w języku angielskim LocaleID jako ms\0x0409 lub ms\1033. Dostawca SMS akceptuje LocaleID tylko wartości w formacie Microsoft. Listę identyfikatorów ustawień regionalnych przypisanych przez firmę Microsoft można znaleźć.locale IDs

Jeśli potrzebne są ustawienia regionalne dla krajów innych niż Stany Zjednoczone instalacje, można ją uzyskać z właściwości klasy LocaleIDWMI serwera SMS_Identification.

MachineName (Nazwa komputera)

Kwalifikator MachineName kontekstu jest wartością ciągu, która identyfikuje komputer, na którym jest uruchomiona aplikacja. Należy określić MachineName dla swojej aplikacji, ponieważ jest ona używana do inspekcji. Jeśli nazwa komputera nie zostanie podana, zostanie użyta wartość Nieznane. Musisz podać wartość MachineName podczas wywoływania dowolnej z metod podnoszenia komunikatu o stanie, takich jak SMS_StatusMessage::RaiseRawStatusMsg, w przeciwnym razie wywołanie zakończy się niepowodzeniem.

QueryQualifiers

Kwalifikator QueryQualifiers kontekstu jest wartością logiczną używaną do zwracania flag bitowych SecurityVerbs podczas wykonywania zapytań względem zabezpieczonych obiektów, takich jak SMS_Site lub SMS_Package. Należy pamiętać, że użycie QueryQualifiers podczas wykonywania zapytań o niezabezpieczone obiekty generuje błąd. Domyślnie flagi SecurityVerbs nie są zwracane z zapytaniem. Należy utworzyć ten kwalifikator i ustawić jego wartość true , jeśli chcesz, aby flagi były zwracane. Nieutworzenie QueryQualifiers jest równoznaczne z ustawieniem jego wartości na false.

SessionHandle (Uchwyt sesji)

Kwalifikator SessionHandle kontekstu jest wartością ciągu, która jest zwracana jako parametr out metody GetSessionHandle. Ciąg jest unikatowym identyfikatorem GUID, który identyfikuje kopię pliku kontroli lokacji aplikacji w programie Configuration Manager. Tego mechanizmu należy użyć do zmodyfikowania pliku kontrolnego lokacji i ograniczenia kolizji danych z innymi aplikacjami, które jednocześnie modyfikują plik kontrolny lokacji. Jeśli nie podasz SessionHandle wartości, aplikacja zmodyfikuje kopię globalną pliku kontroli witryny, która nie jest chroniona przed nadpisywaniem przez aplikacje swoich danych.

Zobacz też

Jak dodać kwalifikator kontekstu programu Configuration Manager przy użyciu kodu zarządzanegoJak dodać kwalifikator kontekstu programu Configuration Manager przy użyciu usługi WMIPodstawy dostawcy SMS