Método SWbemObject.Subclasses_
El método Subclasses_ del objeto SWbemObject devuelve un objeto SWbemObjectSet. Este objeto es una colección de subclases del objeto actual, que debe ser una clase. Los elementos de la colección devuelta se pueden obtener mediante métodos de colección estándar. Para más información, consulte Acceso a una colección.
Para una explicación de esta sintaxis, consulte Convenciones de documentación para la API de scripting.
Sintaxis
objWbemObjectSet = .Subclasses_( _
[ ByVal iFlags ], _
[ ByVal objwbemNamedValueSet ] _
)
Parámetros
-
iFlags [entrada, opcional]
-
Entero que determina qué tan detallada es la enumeración de la llamada. Este parámetro puede aceptar los valores siguientes.
-
wbemQueryFlagDeep (0 (0x0))
-
Fuerza la enumeración recursiva en todas las subclases derivadas de la clase primaria especificada. La clase principal misma no se devuelve en la enumeración.
-
wbemQueryFlagShallow (1 (0x1))
-
Valor predeterminado para este parámetro. Fuerza a la enumeración a incluir solo subclases inmediatas de la clase primaria especificada.
-
WbemFlagReturnImmediately (16 (0x10))
-
Hace que la llamada se devuelva inmediatamente.
-
wbemFlagReturnWhenComplete (0 (0x0))
-
Hace que esta llamada se bloquee hasta que se haya completado la llamada.
-
wbemFlagUseAmendedQualifiers (131072 (0x20000))
-
Hace que WMI devuelva datos de modificación de clase junto con la definición de clase base.
objwbemNamedValueSet [entrada, opcional]
Normalmente, esto no está definido. De lo contrario, se trata de un objeto SWbemNamedValueSet cuyos elementos representan la información de contexto que puede usar el proveedor que atiende la solicitud. Un proveedor que admita o necesite esa información debe documentar los nombres de valor reconocidos, el tipo de datos del valor, los valores permitidos y la semántica.
Valor devuelto
Si la llamada se realiza correctamente, se devolverá un objeto SWbemObjectSet.
Códigos de error
Después de completar el método Subclasses_, el objeto Err puede contener uno de los códigos de error de la lista siguiente.
-
wbemErrAccessDenied - 2147749891 (0x80041003)
-
El usuario no tiene permiso para ver una o varias de las clases devueltas por la llamada.
-
wbemErrFailed: 2147749889 (0x80041001)
-
Error no especificado.
-
wbemErrInvalidClass - 2147749904 (0x80041010)
-
La clase especificada no existía.
-
wbemErrInvalidParameter - 2147749896 (0x80041008)
-
Se ha especificado un parámetro no válido.
-
wbemErrOutOfMemory: 2147749894 (0x80041006)
-
No hay suficiente memoria para completar la operación.
Comentarios
No es un error que la colección devuelta tenga cero elementos si no hay subclases del objeto actual. El método Subclasses_ solo funciona para objetos de clase.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Encabezado |
|
| Biblioteca de tipos |
|
| Archivo DLL |
|
| CLSID |
CLSID_SWbemObject |
| IID |
IID_ISWbemObject |