GetObjectText függvény

Az objektum szöveges renderelését adja vissza a Managed Object Format (MOF) szintaxisban.

Megjegyzés

Ez az API csak belső használatra készült. Nem fejlesztői kódból való használatra készült.

Szintaxis

HRESULT GetObjectText (
   [in] int                vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LONG                lFlags,
   [out] BSTR*              pstrObjectText
);

Paraméterek

vFunc
[in] Ez a paraméter nem használható.

ptr
[in] Egy IWbemClassObject-példányra mutató mutató.

lFlags
[in] Általában 0. Ha WBEM_FLAG_NO_FLAVORS (vagy 0x1) meg van adva, a minősítők propagálási vagy ízinformációk nélkül jelennek meg.

pstrObjectText [kifelé] Mutató egy null bejegyzésre. Visszatéréskor egy újonnan lefoglalt BSTR elem, amely az objektum MOF-szintaxisának renderelését tartalmazza.

Visszatérési érték

A függvény által visszaadott alábbi értékek a WbemCli.h fejlécfájlban vannak definiálva, vagy konstansként definiálhatók a kódban:

Állandó	Érték	Leírás
WBEM_E_FAILED	0x80041001	Általános hiba történt.
WBEM_E_INVALID_PARAMETER	0x80041008	A paraméter érvénytelen.
WBEM_E_OUT_OF_MEMORY	0x80041006	Nincs elég memória a művelet végrehajtásához.
WBEM_S_NO_ERROR	0	A függvényhívás sikeres volt.

Megjegyzések

Ez a függvény körbefuttat egy hívást az IWbemClassObject::GetObjectText metódushoz.

A visszaadott MOF-szöveg nem tartalmazza az objektumra vonatkozó összes információt, de csak annyi információt, hogy az MOF-fordító újra létre tudja hozni az eredeti objektumot. A rendszer például nem tartalmaz propagált minősítőket vagy szülőosztály-tulajdonságokat.

A metódus paramétereinek szövegének rekonstruálása a következő algoritmussal történik:

1. A paraméterek az azonosítóértékek sorrendjében lesznek újrakonveklaráltak.
2. A és paraméterként [in] megadott paraméterek [out] egyetlen paraméterbe vannak kombinálva.

pstrObjectText a függvény meghívásakor mutatónak kell lennie null ; nem mutathat olyan sztringre, amely érvényes a metódushívás előtt, mert a mutató nem lesz felszabadítva.

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: WMINet_Utils.idl

.NET-keretrendszer verziók: 4.7.2-től érhető el

Lásd még

• WMI- és teljesítményszámlálók (nem felügyelt API-referencia)