Metodo IWbemClassObject::GetObjectText (wbemcli.h)

  • Articolo

Il metodo IWbemClassObject::GetObjectText restituisce un rendering testuale dell'oggetto nella sintassi MOF. Si noti che il testo MOF restituito non contiene tutte le informazioni sull'oggetto, ma solo informazioni sufficienti per il compilatore MOF per poter ricreare l'oggetto originale. Ad esempio, non vengono visualizzati qualificatori propagati o proprietà della classe padre.

Sintassi

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

Parametri

[in] lFlags

Normalmente 0. Se si specifica WBEM_FLAG_NO_FLAVORS , i qualificatori verranno presentati senza informazioni sulla propagazione o sul sapore.

[out] pstrObjectText

Deve puntare a NULL all'immissione. Questo parametro riceve da Gestione Windows un BSTR appena allocato inizializzato con SysAllocString. È necessario chiamare SysFreeString sul puntatore quando la stringa non è più necessaria. Questo puntatore punta a un rendering della sintassi MOF dell'oggetto al momento della restituzione dalla chiamata. Poiché si tratta di un parametro out, il puntatore non deve puntare a una stringa valida prima della chiamata a questo metodo, perché il puntatore non verrà deallocato.

Valore restituito

Questo metodo restituisce un valore HRESULT che indica lo stato della chiamata al metodo. L'elenco seguente elenca il valore contenuto in hrESULT. Per i valori HRESULT generali, vedere Codici di errore di sistema.

Commenti

L'algoritmo seguente viene usato per ricostruire il testo dei parametri di un metodo:

  1. I parametri vengono reinquenceati nell'ordine dei valori degli identificatori.
  2. I parametri specificati come [in] e [out] verranno combinati in un singolo parametro.

Requisiti

   
Client minimo supportato Windows Vista
Server minimo supportato Windows Server 2008
Piattaforma di destinazione Windows
Intestazione wbemcli.h (include Wbemidl.h)
Libreria WbemUuid.lib
DLL CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll

Vedi anche

IWbemClassObject

IWbemQualifierSet

WBEM_TEXT_FLAG_TYPE