GetObjectText-Funktion

  • Artikel

Gibt ein Textrendering des Objekts in MOF-Syntax (Managed Object Format) zurück.

Hinweis

Diese API ist ausschließlich für die interne Verwendung vorgesehen. Sie ist nicht für die Verwendung im Entwicklercode vorgesehen.

Syntax

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

Parameter

vFunc
[in] Dieser Parameter wird nicht verwendet.

ptr
[in] Ein Zeiger auf eine IWbemClassObject-Instanz.

lFlags
[in] Normalerweise 0. Wenn WBEM_FLAG_NO_FLAVORS (oder 0x1) angegeben ist, werden Qualifizierer ohne Weitergabe- oder Varianteninformationen eingeschlossen.

pstrObjectText [out] Ein Zeiger auf einen null--Eintrag. Bei Rückgabe eine neu zugeordnete BSTR, die ein Rendering des Objekts in MOF-Syntax enthält.

Rückgabewert

Die folgenden von dieser Funktion zurückgegebenen Werte werden in der WbemCli.h-Headerdatei definiert, oder Sie können sie als Konstanten im Code definieren:

Konstante Wert BESCHREIBUNG
WBEM_E_FAILED 0x80041001 Es ist ein allgemeiner Fehler aufgetreten.
WBEM_E_INVALID_PARAMETER 0x80041008 Ein Parameter ist nicht gültig.
WBEM_E_OUT_OF_MEMORY 0x80041006 Es ist nicht genügend Arbeitsspeicher verfügbar, um den Vorgang abzuschließen.
WBEM_S_NO_ERROR 0 Der Funktionsaufruf war erfolgreich.

Bemerkungen

Diese Funktion umschließt einen Aufruf der IWbemClassObject::GetOrigin-Methode.

Der zurückgegebene MOF-Text enthält nicht alle Informationen über das Objekt, sondern nur genügend Informationen, damit der MOF-Compiler das ursprüngliche Objekt wiederherstellen kann. Beispielsweise sind keine weitergegebenen Qualifizierer oder übergeordneten Klasseneigenschaften enthalten.

Der folgende Algorithmus wird verwendet, um den Text der Parameter einer Methode zu rekonstruieren:

  1. Parameter werden in der Reihenfolge ihrer Bezeichnerwerte neu angeordnet.
  2. Parameter, die als [in] und [out] angegeben sind, werden in einem einzelnen Parameter kombiniert.

pstrObjectText muss ein Zeiger auf eine null sein, wenn die Funktion aufgerufen wird. Er darf nicht auf eine Zeichenfolge zeigen, die vor dem Methodenaufruf gültig ist, da die Zuordnung des Zeigers nicht aufgehoben wird.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: WMINet_Utils.idl

.NET Framework-Versionen: Seit Version 4.7.2 verfügbar

Weitere Informationen