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	Wbemdisp.h
Biblioteca de tipos	Wbemdisp.tlb
Archivo DLL	Wbemdisp.dll
CLSID	CLSID_SWbemObject
IID	IID_ISWbemObject

Consulte también

SWbemObject

SWbemObjectSet