SWbemObject.Instances_ metodo

Il metodo Instances_ dell'oggetto SWbemObject crea un enumeratore che restituisce le istanze dell'oggetto classe corrente. Questo metodo implementa una semplice query. Le query più complesse possono richiedere l'uso di SWbemServices.ExecQuery.

Per una spiegazione di questa sintassi, vedere Convenzioni di documento per l'API scripting.

Sintassi

objWbemObjectSet = .Instances_( _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ] _
)

Parametri

iFlags [in, facoltativo]

Intero che determina il comportamento della chiamata. Questo parametro può accettare i valori seguenti.

wbemFlagForwardOnly (32 (0x20))

Causa la restituzione di un enumeratore forward-only. Gli enumeratori solo in avanti sono in genere molto più veloci e usano meno memoria rispetto agli enumeratori convenzionali, ma non consentono chiamate a SWbemObject.Clone_.

wbemFlagBidirectional (0 (0x0))

Consente a WMI di conservare i puntatori agli oggetti dell'enumerazione fino a quando il client rilascia l'enumeratore.

wbemFlagReturnImmediately (16 (0x10))

Valore predefinito per questo parametro. Questo flag causa immediatamente la restituzione della chiamata.

wbemFlagReturnWhenComplete ( 0 (0x0))

Causa il blocco della chiamata fino al completamento della query.

wbemQueryFlagShallow (1 (0x1))

Forza l'enumerazione per includere solo sottoclassi immediate della classe padre specificata.

wbemQueryFlagDeep (0 (0x0))

Impostazione predefinita per questo parametro. Questo valore impone all'enumerazione di includere tutte le classi nella gerarchia.

wbemFlagUseAmendedQualifiers (131072 (0x20000))

Consente a WMI di restituire i dati di modifica della classe con la definizione della classe di base.

objwbemNamedValueSet [in, facoltativo]

In genere, questo è indefinito. In caso contrario, si tratta di un oggetto SWbemNamedValueSet i cui elementi rappresentano le informazioni di contesto che possono essere usate dal provider che esegue la manutenzione della richiesta. Un provider che supporta o richiede tali informazioni deve documentare i nomi di valore riconosciuti, il tipo di dati del valore, i valori consentiti e la semantica.

Valore restituito

Se il metodo ha esito positivo, viene restituito un oggetto SWbemObjectSet .

Codici di errore

Al termine del metodo Instances_ , l'oggetto Err può contenere uno dei codici di errore nell'elenco seguente.

wbemErrAccessDenied - 2147749891 (0x80041003)

L'utente corrente non dispone dell'autorizzazione per visualizzare le istanze della classe specificata.

wbemErrFailed - 2147749889 (0x80041001)

Si è verificato un errore non specificato.

wbemErrInvalidClass - 2147749904 (0x80041010)

La classe specificata non è valida.

wbemErrInvalidParameter - 2147749896 (0x80041008)

Un parametro specificato non è valido.

wbemErrOutOfMemory - 2147749894 (0x80041006)

Memoria insufficiente per completare l'operazione.

Commenti

Il metodo Instances_ funziona solo per gli oggetti di classe. Non è un errore per la raccolta restituita per avere zero elementi. Il comportamento predefinito per questo metodo è semisynchrono a causa del valore IFlags predefinito wbemFlagReturnImmediately.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Intestazione	Wbemdisp.h
Libreria dei tipi	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemObject
IID	IID_ISWbemObject

Vedi anche

SWbemObject

SWbemObjectSet