GetObjectText, funkcja

Zwraca tekstowe renderowanie obiektu w składni Formatu obiektów zarządzanych (MOF).

Uwaga

Ten interfejs API jest przeznaczony tylko do użytku wewnętrznego. Nie jest przeznaczony do użycia z poziomu kodu dewelopera.

Składnia

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

Parametry

vFunc
[in] Ten parametr jest nieużywany.

ptr
[in] Wskaźnik do wystąpienia IWbemClassObject .

lFlags
[in] Zwykle 0. W przypadku WBEM_FLAG_NO_FLAVORS określenia (lub 0x1) kwalifikatory są uwzględniane bez propagacji ani informacji o smaku.

pstrObjectText [out] Wskaźnik do null wpisu on. Po powrocie nowo przydzielona, BSTR która zawiera renderowanie składni MOF obiektu.

Wartość zwracana

Następujące wartości zwracane przez tę funkcję są definiowane w pliku nagłówkowym WbemCli.h lub można je zdefiniować jako stałe w kodzie:

Stała	Wartość	Opis
WBEM_E_FAILED	0x80041001	Wystąpiła ogólna awaria.
WBEM_E_INVALID_PARAMETER	0x80041008	Parametr jest nieprawidłowy.
WBEM_E_OUT_OF_MEMORY	0x80041006	Za mało pamięci, aby ukończyć operację.
WBEM_S_NO_ERROR	0	Wywołanie funkcji zakończyło się pomyślnie.

Uwagi

Ta funkcja opakowuje wywołanie metody IWbemClassObject::GetObjectText .

Zwrócony tekst MOF nie zawiera wszystkich informacji o obiekcie, ale tylko wystarczające informacje dla kompilatora MOF, aby można było odtworzyć oryginalny obiekt. Na przykład nie są uwzględniane żadne propagowane kwalifikatory ani właściwości klasy nadrzędnej.

Następujący algorytm służy do odtworzenia tekstu parametrów metody:

1. Parametry są ponownie sekwencjonowane w kolejności ich wartości identyfikatora.
2. Parametry określone jako [in] i [out] są łączone w jeden parametr.

pstrObjectText musi być wskaźnikiem do null wywołania funkcji, ponieważ nie może wskazywać ciągu, który jest prawidłowy przed wywołaniem metody, ponieważ wskaźnik nie zostanie cofnięty.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: WMINet_Utils.idl

wersje .NET Framework: dostępne od wersji 4.7.2

Zobacz też

• Liczniki usługi WMI i wydajności (niezarządzana dokumentacja interfejsu API)