Put, funkcja

Ustawia nazwaną właściwość na nową wartość.

Uwaga

Ten interfejs API jest przeznaczony tylko do użytku wewnętrznego. Nie jest przeznaczony do użycia z poziomu kodu dewelopera.

Składnia

HRESULT Put (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LPCWSTR           wszName,
   [in] LONG              lFlags,
   [in] VARIANT*          pVal,
   [in] CIMTYPE           vtType
);

Parametry

vFunc
[in] Ten parametr jest nieużywany.

ptr
[in] Wskaźnik do wystąpienia IWbemClassObject .

wszName
[in] Nazwa właściwości. Ten parametr nie może mieć wartości null.

lFlags
[in] Zastrzeżone. Ten parametr musi mieć wartość 0.

pVal
[in] Wskaźnik do prawidłowej VARIANT wartości, która staje się nową wartością właściwości. Jeśli pVal parametr ma null typ VT_NULLlub wskazuje VARIANT wartość , właściwość jest ustawiona na nullwartość .

vtType
[in] Typ wskazywany VARIANT przez pVal. Aby uzyskać więcej informacji, zobacz sekcję Uwagi .

Wartość zwracana

Następujące wartości zwracane przez tę funkcję są definiowane w pliku nagłówkowym WbemCli.h lub można je zdefiniować jako stałe w kodzie:

Stała	Wartość	Opis
WBEM_E_FAILED	0x80041001	Wystąpiła ogólna awaria.
WBEM_E_INVALID_PARAMETER	0x80041008	Co najmniej jeden parametr jest nieprawidłowy.
WBEM_E_INVALID_PROPERTY_TYPE	0x8004102a	Typ właściwości nie jest rozpoznawany. Ta wartość jest zwracana podczas tworzenia wystąpień klas, jeśli klasa już istnieje.
WBEM_E_OUT_OF_MEMORY	0x80041006	Za mało pamięci, aby ukończyć operację.
WBEM_E_TYPE_MISMATCH	0x80041005	Dla wystąpień: wskazuje, że pVal wskazuje VARIANT na nieprawidłowy typ właściwości. W przypadku definicji klas: właściwość już istnieje w klasie nadrzędnej, a nowy typ COM różni się od starego typu COM.
WBEM_S_NO_ERROR	0	Wywołanie funkcji zakończyło się pomyślnie.

Uwagi

Ta funkcja opakowuje wywołanie metody IWbemClassObject::P ut .

Ta funkcja zawsze zastępuje bieżącą wartość właściwości nową. Jeśli klasa IWbemClassObject wskazuje definicję klasy, Put tworzy lub aktualizuje wartość właściwości. Gdy klasa IWbemClassObject wskazuje wystąpienie modelu CIM, Put aktualizuje tylko wartość właściwości; Put nie można utworzyć wartości właściwości.

Właściwość __CLASS systemowa jest zapisywalna tylko podczas tworzenia klasy, gdy może nie być pusta. Wszystkie inne właściwości systemu są tylko do odczytu.

Użytkownik nie może utworzyć właściwości o nazwach rozpoczynających się lub kończących znakiem podkreślenia ("_"). Jest to zarezerwowane dla klas systemowych i właściwości.

Jeśli właściwość ustawiona przez Put funkcję istnieje w klasie nadrzędnej, wartość domyślna właściwości zostanie zmieniona, chyba że typ właściwości jest niezgodny z typem klasy nadrzędnej. Jeśli właściwość nie istnieje i nie jest niezgodna z typem, właściwość zostanie utworzona.

Użyj parametru vtType tylko podczas tworzenia nowych właściwości w definicji klasy modelu CIM i pVal wskazuje null typ VARIANTVT_NULLlub wskazuje wartość typu . W tym przypadku vType parametr określa typ modelu CIM właściwości. W każdym innym przypadku vtType wartość musi mieć wartość 0. vtType element musi również mieć wartość 0, jeśli obiekt źródłowy jest wystąpieniem (nawet jeśli Val jest null), ponieważ typ właściwości jest stały i nie można go zmienić.

Przykład

Aby zapoznać się z przykładem, zobacz metodę IWbemClassObject::P ut .

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: WMINet_Utils.idl

wersje .NET Framework: dostępne od wersji 4.7.2

Zobacz też

• Liczniki usługi WMI i wydajności (niezarządzana dokumentacja interfejsu API)