Condividi tramite

Funzione GetObjectText

  • Articolo

Restituisce un rendering testuale dell'oggetto nella sintassi MOF (Managed Object Format).

Nota

Questa API è solo per uso interno. Non è destinata all'uso dal codice dello sviluppatore.

Sintassi

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

Parametri

vFunc
[in] Questo parametro è inutilizzato.

ptr
[in] Puntatore a un'istanza di IWbemClassObject .

lFlags
[in] Normalmente 0. Se WBEM_FLAG_NO_FLAVORS viene specificato (o 0x1), i qualificatori sono inclusi senza informazioni sulla propagazione o sul sapore.

pstrObjectText [out] Puntatore a una null voce. In caso di ritorno, un nuovo allocato BSTR che contiene un rendering della sintassi MOF dell'oggetto.

Valore restituito

I valori seguenti restituiti da questa funzione sono definiti nel file di intestazione WbemCli.h oppure è possibile definirli come costanti nel codice:

Costante Valore Descrizione
WBEM_E_FAILED 0x80041001 Si è verificato un errore generale.
WBEM_E_INVALID_PARAMETER 0x80041008 Un parametro non è valido.
WBEM_E_OUT_OF_MEMORY 0x80041006 Memoria insufficiente per completare l’operazione.
WBEM_S_NO_ERROR 0 La chiamata alla funzione ha avuto esito positivo.

Commenti

Questa funzione esegue il wrapping di una chiamata al metodo IWbemClassObject::GetObjectText .

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 sono inclusi qualificatori propagati o proprietà della classe padre.

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

  1. I parametri vengono riquenced nell'ordine dei valori dell'identificatore.
  2. Parametri specificati come [in] e [out] combinati in un singolo parametro.

pstrObjectText deve essere un puntatore a un null quando viene chiamata la funzione. Non deve puntare a una stringa valida prima della chiamata al metodo, perché il puntatore non verrà deallocato.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: WMINet_Utils.idl

Versioni di .NET Framework: Disponibile da 4.7.2

Vedi anche