Funkce GetObjectText

Vrátí textové vykreslení objektu v syntaxi MOF (Managed Object Format).

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 GetObjectText (
   [in] int                vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LONG                lFlags,
   [out] BSTR*              pstrObjectText
);

Parametry

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

ptr
[v] Ukazatel na instanci IWbemClassObject .

lFlags
[v] Obvykle 0. Pokud WBEM_FLAG_NO_FLAVORS je zadán (nebo 0x1), jsou kvalifikátory zahrnuty bez šíření nebo informací o příchutě.

pstrObjectText [out] Ukazatel na null položku on. Při vrácení nově přidělený BSTR objekt, který obsahuje vykreslení syntaxe MOF objektu.

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_FAILED	0x80041001	Došlo k obecné chybě.
WBEM_E_INVALID_PARAMETER	0x80041008	Parametr není platný.
WBEM_E_OUT_OF_MEMORY	0x80041006	K dokončení operace není k dispozici dostatek paměti.
WBEM_S_NO_ERROR	0	Volání funkce bylo úspěšné.

Poznámky

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

Vrácený text MOF neobsahuje všechny informace o objektu, ale pouze dostatek informací, aby kompilátor MOF mohl znovu vytvořit původní objekt. Například nejsou zahrnuty žádné šířené kvalifikátory nebo nadřazené vlastnosti třídy.

Následující algoritmus se používá k rekonstrukci textu parametrů metody:

1. Parametry se mění v pořadí hodnot jejich identifikátorů.
2. Parametry, které jsou zadány jako [in] a [out] jsou sloučeny do jednoho parametru.

pstrObjectText Musí být ukazatelem na null funkci při volání funkce; nesmí odkazovat na řetězec, který je platný před voláním metody, protože ukazatel nebude uvolněn.

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)