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

El método IWbemConfigureRefresher::AddEnum agrega un enumerador al actualizador solicitado.

Sintaxis

HRESULT AddEnum(
  [in]  IWbemServices   *pNamespace,
  [in]  LPCWSTR         wszClassName,
  [in]  long            lFlags,
  [in]  IWbemContext    *pContext,
  [out] IWbemHiPerfEnum **ppEnum,
  [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. Si el método debe volver a llamar a Administración de Windows durante su ejecución, el proveedor debe llamar a AddRef con el puntero pNamespace .

[in] wszClassName

Constante, cadena terminada en null de caracteres Unicode de 16 bits que contienen el nombre de la clase que se enumera.

[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, las instancias devueltas contienen calificadores localizados si están disponibles.

[in] pContext

Normalmente NULL; de lo contrario, se trata de un puntero a un objeto IWbemContext que requiere 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] ppEnum

Puntero que contiene la referencia a un objeto IWbemHiPerfEnum , que contendrá la enumeración. El cliente debe llamar a Release en este puntero cuando ya no sea necesario.

[out] plId

Puntero a un entero devuelto por el proveedor que identifica de forma única la enumeración 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

NotaHRESULT

 

.

Comentarios

La clase proporcionada debe especificar una clase válida, proporcionada por el proveedor de High-Performance. Todas las instancias del enumerador devuelto se pueden consultar después de las llamadas. En cada llamada para actualizar, el número de instancias del enumerador puede variar. Solo se devuelven instancias del nombre de clase especificado; No se enumerarán las subclases de la clase especificada porque no se admite la enumeración detallada. El cliente no debe tocar el enumerador devuelto mientras se está procesando una operación de actualización . La función Remove puede usar el identificador devuelto para quitar el objeto. Tenga en cuenta que no es necesario que el usuario quite explícitamente los enumeradores agregados. Sin embargo, el cliente debe llamar a Release en el enumerador devuelto cuando ya no es 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

IWbemConfigureRefresher