Metodo SWbemServices.SubclassesOf
Il metodo SubclassesOf dell'oggetto SWbemServices restituisce un oggetto SWbemObjectSet . Questo oggetto è una raccolta di sottoclassi di una classe specificata. Gli elementi della raccolta restituita possono essere ottenuti usando metodi di raccolta standard. Per altre informazioni, vedere Accesso a una raccolta.
Questo metodo funziona solo per gli oggetti di classe.
Il metodo viene chiamato nella modalità semisynchronous. Per altre informazioni, vedere Chiamata di un metodo.
Per una spiegazione di questa sintassi, vedere Convenzioni di documento per l'API scripting.
Sintassi
objWbemObjectSet = .SubclassesOf( _
[ ByVal strSuperclass ], _
[ ByVal iFlags ], _
[ ByVal objWbemNamedValueSet ] _
)
Parametri
-
strSuperclass [facoltativo]
-
Specifica un nome di classe padre. Solo le sottoclassi di questa classe restituiscono nell'enumeratore. Se si lascia vuoto questo parametro e se iFlags è wbemQueryFlagShallow, vengono restituite solo le classi di primo livello, ovvero le classi che non hanno una classe padre. Se questo parametro è vuoto e iFlags è wbemQueryFlagDeep tutte le classi all'interno dello spazio dei nomi vengono restituite.
-
iFlags [facoltativo]
-
Determina la modalità di enumerazione dettagliata della chiamata. I valori predefiniti per questo parametro sono wbemFlagReturnImmediately e wbemQueryFlagDeep. Questo parametro può accettare i valori seguenti.
-
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 forza l'enumerazione ricorsiva in tutte le sottoclassi derivate dalla classe padre specificata. La classe padre non viene restituita nell'enumerazione.
-
wbemFlagReturnImmediately (16 (0x10))
-
Causa la restituzione immediata della chiamata.
-
wbemFlagReturnWhenComplete (0 (0x0))
-
Causa il blocco della chiamata fino al completamento della chiamata. Questo flag chiama il metodo nella modalità sincrona.
-
wbemFlagUseAmendedQualifiers (131072 (0x20000))
-
Consente a WMI di restituire i dati di modifica della classe con la definizione della classe di base. Per altre informazioni, vedere Localizzazione delle informazioni sulla classe WMI.
objWbemNamedValueSet [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 SubclassesOf , l'oggetto Err può contenere uno dei codici di errore nell'elenco seguente.
Nota
Una raccolta restituita con zero elementi non è un errore.
-
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.
Esempio
L'esempio di PowerShell seguente illustra come recuperare le sottoclassi di una classe in un sistema remoto.
$NameSpace = 'root\ccm'
$ComputerName = 'sccm.company.com'
$WbemLocator = New-Object -ComObject "WbemScripting.SWbemLocator"
$WbemServices = $WbemLocator.ConnectServer($ComputerName, $Namespace)
$WbemClasses = $WbemServices.SubclassesOf()
$WbemClasses
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista |
| Server minimo supportato |
Windows Server 2008 |
| Intestazione |
|
| Libreria dei tipi |
|
| DLL |
|
| CLSID |
CLSID_SWbemServices |
| IID |
IID_ISWbemServices |