Condividi tramite

Metodo IWbemObjectTextSrc::GetText (wbemcli.h)

  • Articolo

Il metodo IWbemObjectTextSrc::GetText crea una rappresentazione testuale di un oggetto IWbemClassObject ; Ad esempio, una rappresentazione XML.

Sintassi

HRESULT GetText(
  long             lFlags,
  IWbemClassObject *pObj,
  ULONG            uObjTextFormat,
  IWbemContext     *pCtx,
  BSTR             *strText
);

Parametri

lFlags

Riservato. Deve essere 0L.

pObj

Riferimento all'oggetto da rappresentare in formato di testo. Questo parametro non può essere NULL.

uObjTextFormat

Definizione del formato di testo usato per rappresentare l'oggetto. Per altre informazioni sui valori validi per questo parametro, vedere Osservazioni.

WMI_OBJ_TEXT_CIM_DTD_2_0 (1 (0x1))

Usare il DTD corrispondente a CIM DTD versione 2.0.

WMI_OBJ_TEXT_WMI_DTD_2_0 (2 (0x2))

Usare WMI DTD che corrisponde a CIM DTD versione 2.0. L'uso di questo valore consente estensioni specifiche di WMI, ad esempio oggetti incorporati o ambito.

WMI_OBJ_TEXT_WMI_EXT1 (3 (0x3))

Riservato per utilizzi futuri.

WMI_OBJ_TEXT_WMI_EXT2 (4 (0x4))

Riservato per utilizzi futuri.

WMI_OBJ_TEXT_WMI_EXT3 (5 (0x5))

Riservato per utilizzi futuri.

WMI_OBJ_TEXT_WMI_EXT4 (0x6))

Riservato per utilizzi futuri.

WMI_OBJ_TEXT_WMI_EXT5 (7 (0x7))

Riservato per utilizzi futuri.

WMI_OBJ_TEXT_WMI_EXT6 (8 (0x8))

Riservato per utilizzi futuri.

WMI_OBJ_TEXT_WMI_EXT7 (9 (0x9))

Riservato per utilizzi futuri.

WMI_OBJ_TEXT_WMI_EXT8 (10 (0xA))

Riservato per utilizzi futuri.

WMI_OBJ_TEXT_WMI_EXT9 (11 (0xB))

Riservato per utilizzi futuri.

WMI_OBJ_TEXT_WMI_EXT10 (12 (0xC))

Riservato per utilizzi futuri.

WMI_OBJ_TEXT_LAST (13 (0xD))

Riservato per utilizzi futuri.

pCtx

facoltativo. Oggetto Context per l'operazione. L'oggetto context può essere usato per specificare se alcune parti dell'oggetto sono rappresentate nel testo; ad esempio, se includere qualificatori nella rappresentazione testuale. L'oggetto context accetta i valori facoltativi seguenti.

LocalOnly (VT_BOOL)

Se TRUE, sono presenti solo proprietà e metodi definiti in locale nel codice XML risultante. Il valore predefinito è FALSE.

IncludeQualifiers (VT_BOOL)

Se TRUE, i qualificatori di classi, istanze, proprietà e metodi sono inclusi nell'output. Il valore predefinito è FALSE.

PathLevel (VT_I4)

Il valore predefinito è 0 (zero).

I valori possibili sono:

  • 0

    Viene creato un elemento CLASS o INSTANCE a seconda che l'oggetto sia una classe o un'istanza.

  • 1

    VALORE. L'elemento NAMEDOBJECT viene generato.

  • 2

    VALORE. L'elemento OBJECTWITHLOCALPATH viene generato.

  • 3

    VALORE. L'elemento OBJECTWITHPATH viene generato.

ExcludeSystemProperties (VT_BOOL)

Se TRUE, le proprietà di sistema, come __NAMESPACE, sono assenti nell'output. Il valore predefinito è FALSE.

IncludeClassOrigin (VT_BOOL)

Se TRUE, l'attributo di origine della classe è impostato sugli elementi PROPERTY e METHOD . Il valore predefinito è FALSE.

strText

Rappresentazione testuale dell'oggetto. L'utente deve liberare la stringa usando SysFreeString al termine di strText.

Valore restituito

Questo metodo restituisce un HRESULT che indica lo stato della chiamata al metodo. L'elenco seguente elenca il valore contenuto in un HRESULT.

Commenti

Per altre informazioni, vedere Rappresentazione di oggetti in XML.

Requisiti

Requisito Valore
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 Fastprox.dll