Método IWbemConfigureRefresher::AddObjectByTemplate (wbemcli.h)

Con el método IWbemConfigureRefresher::AddObjectByTemplate , puede agregar un objeto que desee actualizar a un actualizador especificando una plantilla de instancia IWbemClassObject . Utilice este método cuando sea difícil construir una ruta de acceso de objeto para que un objeto se agregue a un actualizador.

Nota Las propiedades clave del objeto de instancia deben rellenarse para poder llamar al método AddObjectByTemplate .

 

Sintaxis

HRESULT AddObjectByTemplate(
        IWbemServices    *pNamespace,
  [in]  IWbemClassObject *pTemplate,
  [in]  long             lFlags,
  [in]  IWbemContext     *pContext,
  [out] IWbemClassObject **ppRefreshable,
  [out] long             *plId
);

Parámetros

pNamespace

Un puntero IWbemServices de nuevo a administración de Windows, que puede atender cualquier solicitud realizada por el proveedor. El proveedor debe llamar a AddRef en este puntero si va a volver a llamar a Administración de Windows durante su ejecución.

[in] pTemplate

Puntero a un objeto IWbemClassObject que contiene la plantilla de instancia.

[in] lFlags

Máscara de bits de marcas que modifican el comportamiento de este método. Si este parámetro se establece en WBEM_FLAG_USE_AMENDED_QUALIFIERS, la instancia devuelta contendrá calificadores localizados si está disponible.

[in] pContext

Normalmente NULL; de lo contrario, un puntero a un objeto IWbemContext requerido por uno o varios proveedores de clases dinámicas. Los valores del objeto de contexto deben especificarse en la documentación del proveedor específico. Para obtener más información sobre este parámetro, vea Realizar llamadas a WMI.

[out] ppRefreshable

Puntero para contener la referencia a un objeto IWbemClassObject , que contendrá el objeto de instancia actualizable. El cliente debe llamar a Release en el objeto devuelto cuando ya no sea necesario.

[out] plId

Puntero a un entero devuelto por el proveedor que identifica de forma única este objeto actualizable.

Valor devuelto

Este método devuelve un valor HRESULT que indica el estado de la llamada al método. En la lista siguiente se muestra el valor contenido en un HRESULT.

Comentarios

La instancia proporcionada debe especificar un objeto válido, proporcionado por el proveedor de High-Performance. El cliente no debe modificar el objeto devuelto mientras se está procesando una operación de actualización. La función Remove puede usar el identificador devuelto para quitar el objeto.

No es necesario que el usuario quite explícitamente objetos agregados. El cliente debe llamar a Release en el objeto devuelto cuando ya no sea necesario.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	wbemcli.h (include Wbemidl.h)
Library	Wbemuuid.lib

Consulte también

Acceso a datos de rendimiento en C++

IWbemConfigureRefresher

Convertir un proveedor de instancias en un proveedor de alto rendimiento

Proveedor de contador de rendimiento