WritePropertyValue, funkcja

Zapisuje określoną liczbę bajtów do właściwości identyfikowanej przez dojście właściwości.

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 WritePropertyValue (
   [in] int                  vFunc,
   [in] IWbemObjectAccess*   ptr,
   [in] long                 lHandle,
   [in] long                 lNumBytes,
   [in] byte*                aData
);

Parametry

vFunc
[in] Ten parametr jest nieużywany.

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

lHandle
[in] Liczba całkowita zawierająca dojście identyfikujące tę właściwość. Dojście można pobrać, wywołując funkcję GetPropertyHandle .

lNumBytes
[in] Liczba bajtów zapisywanych we właściwości. Aby uzyskać więcej informacji, zobacz sekcję Uwagi .

pHandle [out] Wskaźnik do tablicy bajtów zawierającej dane.

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_INVALID_PARAMETER	0x80041008	Parametr jest nieprawidłowy.
WBEM_E_TYPE_MISMATCH	0x80041005	Wystąpiła niezgodność typów.
WBEM_S_NO_ERROR	0	Wywołanie funkcji zakończyło się pomyślnie.

Uwagi

Ta funkcja opakowuje wywołanie metody IWbemClassObject::WritePropertyValue .

Użyj tej funkcji, aby ustawić ciąg i wszystkie inne dane inne niżDWORD lub inneQWORD .

W przypadku wartości lNumBytes właściwości innych niż ciąg musi być prawidłowym rozmiarem danych określonego typu właściwości. W przypadku wartości lNumBytes właściwości ciągu musi być długością określonego ciągu w bajtach, a sam ciąg musi mieć parzystą długość w bajtach i mieć znak zakończenia o wartości null.

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)