SWbemObject.Subclasses_ metodo
Il metodo Subclasses_ dell'oggetto SWbemObject restituisce un oggetto SWbemObjectSet. Questo oggetto è una raccolta di sottoclassi dell'oggetto corrente, che deve essere una classe. Gli elementi della raccolta restituita possono essere ottenuti usando metodi di raccolta standard. Per altre informazioni, vedere Accesso a una raccolta.
Per una spiegazione di questa sintassi, vedere Convenzioni di documento per l'API scripting.
Sintassi
objWbemObjectSet = .Subclasses_( _
[ ByVal iFlags ], _
[ ByVal objwbemNamedValueSet ] _
)
Parametri
-
iFlags [in, facoltativo]
-
Intero che determina il dettaglio dell'enumerazione della chiamata. Questo parametro può accettare i valori seguenti.
-
wbemQueryFlagDeep (0 (0x0))
-
Forza l'enumerazione ricorsiva in tutte le sottoclassi derivate dalla classe padre specificata. La classe padre stessa non viene restituita nell'enumerazione.
-
wbemQueryFlagShallow (1 (0x1))
-
Valore predefinito per questo parametro. Forza l'enumerazione per includere solo sottoclassi immediate della classe padre specificata.
-
WbemFlagReturnImmediately (16 (0x10))
-
Causa la restituzione immediata della chiamata
-
wbemFlagReturnWhenComplete (0 (0x0))
-
Causa il blocco della chiamata fino al completamento della chiamata.
-
wbemFlagUseAmendedQualifiers (131072 (0x20000))
-
Consente a WMI di restituire i dati di modifica della classe insieme alla 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 la chiamata ha esito positivo, viene restituito un oggetto SWbemObjectSet .
Codici di errore
Al termine del metodo Subclasses_ , 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 una o più classi restituite dalla chiamata.
-
wbemErrFailed - 2147749889 (0x80041001)
-
Errore non specificato.
-
wbemErrInvalidClass - 2147749904 (0x80041010)
-
La classe specificata non esiste.
-
wbemErrInvalidParameter - 2147749896 (0x80041008)
-
È stato specificato un parametro non valido.
-
wbemErrOutOfMemory - 2147749894 (0x80041006)
-
Memoria insufficiente per completare l'operazione.
Commenti
Non è un errore per l'insieme restituito per avere zero elementi se non sono presenti sottoclassi dell'oggetto corrente. Il metodo Subclasses_ funziona solo per gli oggetti di classe.
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 |