Metodo IWbemServices::GetObject (wbemcli.h)

Articolo
03/08/2023

Il metodo IWbemServices::GetObject recupera una classe o un'istanza. Questo metodo recupera solo oggetti dallo spazio dei nomi associato all'oggetto IWbemServices corrente.

Sintassi

HRESULT GetObject(
  [in]  const BSTR       strObjectPath,
  [in]  long             lFlags,
  [in]  IWbemContext     *pCtx,
  [out] IWbemClassObject **ppObject,
  [out] IWbemCallResult  **ppCallResult
);

Parametri

[in] strObjectPath

Percorso dell'oggetto da recuperare. Se si tratta di NULL, viene restituito un oggetto vuoto che può diventare una nuova classe. Per altre informazioni, vedere Creazione di una classe.

[in] lFlags

I flag seguenti influiscono sul comportamento di questo metodo.

WBEM_FLAG_USE_AMENDED_QUALIFIERS

Se questo flag è impostato, WMI recupera i qualificatori modificati archiviati nello spazio dei nomi localizzato delle impostazioni locali della connessione corrente. Se non è impostato, vengono recuperati solo i qualificatori archiviati nello spazio dei nomi immediato.

WBEM_FLAG_RETURN_WBEM_COMPLETE

Questo flag rende questa chiamata sincrona.

WBEM_FLAG_RETURN_IMMEDIATELY

Questo flag rende questa chiamata semisynchronous. È necessario specificare un puntatore valido per il parametro ppCallResult . Per altre informazioni, vedere Chiamata di un metodo.

WBEM_FLAG_DIRECT_READ

Questo flag causa l'accesso diretto al provider per la classe specificata senza alcun riguardo alla classe padre o alle sottoclassi.

[in] pCtx

In genere NULL. In caso contrario, si tratta di un puntatore a un oggetto IWbemContext che può essere usato dal provider che produce la classe o l'istanza richiesta. I valori nell'oggetto contesto devono essere specificati nella documentazione del provider in questione. Per altre informazioni su questo parametro, vedere Creazione di chiamate a WMI.

[out] ppObject

In caso contrario, questo riceve l'oggetto, se viene trovato. L'oggetto restituito ha un numero di riferimenti positivo. Il chiamante deve usare Release quando l'oggetto non è più necessario. In tutti i casi di errore, questo parametro è impostato su NULL.

[out] ppCallResult

Se NULL, questo parametro non viene usato. Se il parametro lFlags contiene WBEM_FLAG_RETURN_IMMEDIATELY, questa chiamata restituisce immediatamente con WBEM_S_NO_ERROR. Il parametro ppCallResult riceve un puntatore a un nuovo oggetto IWbemCallResult , che può quindi essere eseguito il polling per ottenere il risultato usando il metodo GetCallStatus . Il chiamante può chiamare IWbemCallResult::GetResultObject per recuperare l'oggetto quando diventa disponibile.

Valore restituito

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

In caso di errore, è possibile ottenere informazioni disponibili dalla funzione COM GetErrorInfo.

I codici di errore specifici di COM possono essere restituiti anche se i problemi di rete causano la perdita della connessione remota a Gestione Windows.

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	Fastprox.dll; Esscli.dll; FrameDyn.dll; FrameDynOS.dll; Ntevt.dll; Stdprov.dll; Viewprov.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wbemsvc.dll; Wmipicmp.dll; Wmidcprv.dll; Wmipjobj.dll; Wmiprvsd.dll