Método SWbemObject.Instances_
El método Instances_ del objeto SWbemObject crea un enumerador que devuelve las instancias del objeto de clase actual. Este método implementa una consulta sencilla. Las consultas más complejas pueden requerir el uso de SWbemServices.ExecQuery.
Para obtener una explicación de esta sintaxis, vea Convenciones de documentación para la API de scripting.
Sintaxis
objWbemObjectSet = .Instances_( _
[ ByVal iFlags ], _
[ ByVal objwbemNamedValueSet ] _
)
Parámetros
-
iFlags [in, opcional]
-
Entero que determina el comportamiento de la llamada. Este parámetro puede aceptar los valores siguientes.
-
wbemFlagForwardOnly (32 (0x20))
-
Provoca la devolución de un enumerador de solo avance. Los enumeradores de solo avance suelen ser mucho más rápidos y usan menos memoria que los enumeradores convencionales, pero no permiten llamadas a SWbemObject.Clone_.
-
wbemFlagBidirectional (0 (0x0))
-
Hace que WMI conserve los punteros a objetos de la enumeración hasta que el cliente libere el enumerador.
-
wbemFlagReturnImmediately (16 (0x10))
-
Valor predeterminado para este parámetro. Esta marca hace que la llamada se devuelva inmediatamente.
-
wbemFlagReturnWhenComplete ( 0 (0x0))
-
Provoca que esta llamada se bloquee hasta que se complete la consulta.
-
wbemQueryFlagShallow (1 (0x1))
-
Obliga a la enumeración a incluir solo subclases inmediatas de la clase principal especificada.
-
wbemQueryFlagDeep (0 (0x0))
-
Valor predeterminado para este parámetro. Este valor obliga a la enumeración a incluir todas las clases de la jerarquía.
-
wbemFlagUseAmendedQualifiers (131072 (0x20000))
-
Hace que WMI devuelva datos de modificación de clase con la definición de clase base.
objwbemNamedValueSet [in, optional]
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 el método se ejecuta correctamente, devuelve un objeto SWbemObjectSet.
Códigos de error
Después de completar el método Instances_, el objeto Err puede contener uno de los códigos de error de la lista siguiente.
-
wbemErrAccessDenied: 2147749891 (0x80041003)
-
El usuario actual no tiene permiso para ver las instancias de la clase especificada.
-
wbemErrFailed: 2147749889 (0x80041001)
-
Error no especificado.
-
wbemErrInvalidClass: 2147749904 (0x80041010)
-
La clase especificada no es válida.
-
wbemErrInvalidParameter: 2147749896 (0x80041008)
-
Un parámetro especificado no es válido.
-
wbemErrOutOfMemory: 2147749894 (0x80041006)
-
No hay suficiente memoria para completar la operación.
Comentarios
El método Instances_ solo funciona para objetos de clase. No es un error para que la colección devuelta tenga cero elementos. El comportamiento predeterminado de este método es semiincrónico debido al valor predeterminado de IFlagswbemFlagReturnImmediately.
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 |