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

  • Artículo

El método IWbemConfigureRefresher::AddObjectByPath agrega un objeto a un actualizador especificando una ruta de acceso de objeto.

Sintaxis

HRESULT AddObjectByPath(
  [in]  IWbemServices    *pNamespace,
  [in]  LPCWSTR          wszPath,
  [in]  long             lFlags,
  [in]  IWbemContext     *pContext,
  [out] IWbemClassObject **ppRefreshable,
  [out] long             *plId
);

Parámetros

[in] 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] wszPath

Constante, cadena terminada en null de caracteres Unicode de 16 bits que contiene la ruta de acceso del objeto que se agrega al actualizador.

[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 contiene calificadores localizados si están disponibles.

[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 contiene 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 el 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 ruta de acceso proporcionada debe especificar un objeto válido, proporcionado por el proveedor de High-Performance. El cliente no debe tocar 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.

Nota 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