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 |
|
| Libreria dei tipi |
|
| DLL |
|
| CLSID |
CLSID_SWbemObject |
| IID |
IID_ISWbemObject |