IWbemClassObject::GetObjectText-Methode (wbemcli.h)
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:
- Parameter werden in der Reihenfolge ihrer Bezeichnerwerte neu angeordnet.
- 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 |