WritePropertyValue – funkce

Zapíše zadaný počet bajtů do vlastnosti identifikované popisovačem vlastnosti.

Poznámka

Toto rozhraní API je určené pouze pro interní použití. Není určen pro použití z kódu vývojáře.

Syntaxe

HRESULT WritePropertyValue (
   [in] int                  vFunc,
   [in] IWbemObjectAccess*   ptr,
   [in] long                 lHandle,
   [in] long                 lNumBytes,
   [in] byte*                aData
);

Parametry

vFunc
[v] Tento parametr se nepoužívá.

ptr
[v] Ukazatel na instanci IWbemObjectAccess .

lHandle
[v] Celé číslo obsahující popisovač, který identifikuje tuto vlastnost. Popisovač lze načíst voláním funkce GetPropertyHandle .

lNumBytes
[v] Počet bajtů zapisovaných do vlastnosti Další informace najdete v části Poznámky .

pHandle [out] Ukazatel na pole bajtů, které obsahuje data.

Vrácená hodnota

Následující hodnoty vrácené touto funkcí jsou definovány v hlavičce souboru WbemCli.h nebo je můžete definovat jako konstanty v kódu:

Konstanta	Hodnota	Popis
WBEM_E_INVALID_PARAMETER	0x80041008	Parametr není platný.
WBEM_E_TYPE_MISMATCH	0x80041005	Došlo k neshodě typu.
WBEM_S_NO_ERROR	0	Volání funkce bylo úspěšné.

Poznámky

Tato funkce zabalí volání metody IWbemClassObject::WritePropertyValue .

Pomocí této funkce můžete nastavit řetězec a všechna ostatní data, která nejsouDWORD nebo nejsouQWORD .

Pro hodnoty lNumBytes vlastností bez řetězce musí být velikost dat správná podle zadaného typu vlastnosti. Pro hodnoty lNumBytes vlastností řetězce musí být délka zadaného řetězce v bajtech a samotný řetězec musí mít sudou délku v bajtech a musí být následován znakem ukončení null.

Požadavky

Platformy: Viz Požadavky na systém.

Záhlaví: WMINet_Utils.idl

Verze rozhraní .NET Framework: K dispozici od verze 4.7.2

Viz také

• Rozhraní WMI a čítače výkonu (referenční dokumentace nespravovaného rozhraní API)