Dela via

Funktionen GetObjectText

Returnerar en textåtergivning av objektet i MOF-syntaxen (Managed Object Format).

Anteckning

Det här API:et är endast för internt bruk. Det är inte avsett att användas från utvecklarkod.

Syntax

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

Parametrar

vFunc
[in] Den här parametern används inte.

ptr
[in] En pekare till en IWbemClassObject-instans .

lFlags
[in] Normalt 0. Om WBEM_FLAG_NO_FLAVORS (eller 0x1) anges inkluderas kvalificerare utan spridnings- eller smakinformation.

pstrObjectText [ut] En pekare till en null vid post. Vid retur, en nyligen allokerad BSTR som innehåller en MOF-syntaxåtergivning av objektet.

Returvärde

Följande värden som returneras av den här funktionen definieras i wbemCli.h-huvudfilen , eller så kan du definiera dem som konstanter i koden:

Konstant Värde Beskrivning
WBEM_E_FAILED 0x80041001 Det har uppstått ett allmänt fel.
WBEM_E_INVALID_PARAMETER 0x80041008 En parameter är inte giltig.
WBEM_E_OUT_OF_MEMORY 0x80041006 Det finns inte tillräckligt med minne för att slutföra åtgärden.
WBEM_S_NO_ERROR 0 Funktionsanropet lyckades.

Kommentarer

Den här funktionen omsluter ett anrop till metoden IWbemClassObject::GetObjectText .

MOF-texten som returneras innehåller inte all information om objektet, utan bara tillräckligt med information för att MOF-kompilatorn ska kunna återskapa det ursprungliga objektet. Till exempel ingår inga spridade kvalificerare eller överordnade klassegenskaper.

Följande algoritm används för att rekonstruera texten i parametrarna för en metod:

  1. Parametrarna sekvenseras om i ordningen för deras identifierarvärden.
  2. Parametrar som anges som [in] och [out] kombineras till en enda parameter.

pstrObjectText måste vara en pekare till en null när funktionen anropas. Den får inte peka på en sträng som är giltig före metodanropet, eftersom pekaren inte frigörs.

Krav

Plattformar: Se Systemkrav.

Huvudet: WMINet_Utils.idl

.NET Framework versioner: Tillgänglig sedan 4.7.2

Se även

  • Last updated on