Compartir a través de

Función Get

  • Artículo

Recupera un valor de propiedad especificado, si existe.

Nota

Esta API es solo para uso interno. No está pensada para usarla desde código del desarrollador.

Sintaxis

HRESULT Get (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LPCWSTR           wszName,
   [in] LONG              lFlags,
   [out] VARIANT*         pVal,
   [out] CIMTYPE*         pvtType,
   [out] LONG*            plFlavor
);

Parámetros

vFunc
[in] Este parámetro no se usa.

ptr
[in] Puntero a una instancia de IWbemClassObject.

wszName
[in] Nombre de la propiedad.

lFlags
[in] Reservado. Este parámetro debe ser 0.

pVal
[out] Si la función se devuelve correctamente, contiene el valor de la propiedad wszName. Al argumento pval se le asigna el tipo y el valor correctos para el calificador.

pvtType
[out] Si la función se devuelve correctamente, contiene una constante de tipo CIM que indica el tipo de propiedad. Su valor también puede ser null.

plFlavor
[out] Si la función se devuelve correctamente, recibe información sobre el origen de la propiedad. Su valor puede ser null, o una de las siguientes constantes WBEM_FLAVOR_TYPE definidas en el archivo de encabezado WbemCli.h:

Constante Value Descripción
WBEM_FLAVOR_ORIGIN_SYSTEM 0x40 La propiedad es una propiedad del sistema estándar.
WBEM_FLAVOR_ORIGIN_PROPAGATED 0x20 Para una clase: la propiedad se hereda de la clase primaria.
Para una instancia: la instancia no ha modificado la propiedad, que se hereda de la clase primaria.
WBEM_FLAVOR_ORIGIN_LOCAL 0 Para una clase: la propiedad pertenece a la clase derivada.
Para una instancia: la instancia modifica la propiedad; es decir, se proporciona un valor o se agrega o modifica un calificador.

Valor devuelto

Los siguientes valores que devuelve esta función se definen en el archivo de encabezado WbemCli.h, aunque también puede definirlos como constantes en el código. Puede consultarlos a continuación:

Constante Value Descripción
WBEM_E_FAILED 0x80041001 Si se devuelve este valor, significará que se ha producido un error general.
WBEM_E_INVALID_PARAMETER 0x80041008 Uno o más parámetros no son válidos.
WBEM_E_NOT_FOUND 0x80041002 No se encontró la propiedad especificada.
WBEM_E_OUT_OF_MEMORY 0x80041006 Memoria insuficiente para completar la operación.
WBEM_S_NO_ERROR 0 Si se devuelve este valor, significará que la llamada a la función se realizó correctamente.

Comentarios

Esta función ajusta una llamada al método IWbemClassObject::Get.

La función Get también puede devolver propiedades del sistema.

Al argumento pVal se le asigna el tipo y el valor correctos para el calificador y la función VariantInit COM.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: WMINet_Utils.idl

Versiones de .NET Framework: está disponible desde la versión 4.7.2

Consulte también