Metodo IWbemClassObject::GetObjectText (wbemcli.h)
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:
- I parametri vengono reinquenceati nell'ordine dei valori degli identificatori.
- 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 |