IWbemClassObject::GetObjectText-Methode (wbemcli.h)

  • Artikel

Die IWbemClassObject::GetObjectText-Methode gibt ein Textrendering des Objekts in der MOF-Syntax zurück. Beachten Sie, dass der zurückgegebene MOF-Text nicht alle Informationen zum Objekt enthält, sondern nur genügend Informationen, damit der MOF-Compiler das ursprüngliche Objekt erneut erstellen kann. Für instance werden keine weitergegebenen Qualifizierer oder übergeordneten Klasseneigenschaften angezeigt.

Syntax

HRESULT GetObjectText(
  [in]  long lFlags,
  [out] BSTR *pstrObjectText
);

Parameter

[in] lFlags

Normalerweise 0. Wenn WBEM_FLAG_NO_FLAVORS angegeben ist, werden Qualifizierer ohne Weitergabe- oder Geschmacksinformationen angezeigt.

[out] pstrObjectText

Dies muss beim Eintrag auf NULL verweisen. Dieser Parameter empfängt von der Windows-Verwaltung einen neu zugeordneten BSTR , der mit SysAllocString initialisiert wurde. Sie müssen SysFreeString auf dem Zeiger aufrufen, wenn die Zeichenfolge nicht mehr erforderlich ist. Dieser Zeiger verweist auf ein MOF-Syntaxrendering des Objekts, wenn vom Aufruf zurückgegeben wird. Da es sich um einen Out-Parameter handelt, darf der Zeiger nicht auf eine gültige Zeichenfolge zeigen, bevor diese Methode aufgerufen wird, da der Zeiger nicht zugeordnet wird.

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. Die folgende Liste listet den Wert auf, der in einem HRESULT enthalten ist. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.

Hinweise

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 zu einem einzelnen Parameter kombiniert.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile wbemcli.h (include Wbemidl.h)
Bibliothek WbemUuid.lib
DLL CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll

Weitere Informationen

IWbemClassObject

IWbemQualifierSet

WBEM_TEXT_FLAG_TYPE