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	Wbemdisp.h
Libreria dei tipi	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemObject
IID	IID_ISWbemObject

Vedi anche

SWbemObject

SWbemObjectSet