Inicialización de un proveedor
Una de las primeras tareas que debe codificar para un proveedor es el proceso de inicialización, que cubre las tareas que el proveedor debe realizar que le permitan enviar y recibir información de WMI, controlar un objeto administrado y realizar otras tareas. Cada tipo de proveedor tiene un conjunto diferente de tareas que debe realizar y un conjunto complementario de interfaces únicas.
Sin embargo, todos los proveedores se inicializan mediante la interfaz IWbemProviderInit e informan a WMI de su estado de inicialización con la interfaz IWbemProviderInitSink.
En el procedimiento siguiente se describe cómo inicializar un proveedor.
Para inicializar un proveedor
Implemente IWbemProviderInit::Initialize para su proveedor.
Cuando WMI determina que un cliente requiere los servicios de un proveedor, WMI carga el proveedor llamando al método IWbemProviderInit::Initialize.
Implemente cualquier interfaz única para el tipo de proveedor.
Informe a WMI de que el proveedor ha terminado con la inicialización llamando a IWbemProviderInitSink::SetStatus.
Todas las implementaciones de IWbemProviderInit::Initialize deben llamar a IWbemProviderInitSink::SetStatus para notificar el estado de inicialización a WMI. El método SetStatus permite a WMI determinar si un proveedor está listo para recibir solicitudes y el tipo de solicitudes que el proveedor está listo para recibir.
En el procedimiento siguiente se describe cómo notificar una inicialización correcta.
Para informar de una inicialización correcta
Establezca el parámetro IStatus de SetStatus en WBEM_S_INITIALIZED.
Al devolver WBEM_S_INITIALIZED, un proveedor indica una preparación para controlar las solicitudes de aplicaciones, WMI y otros proveedores. Después de recibir WBEM_S_INITIALIZED, WMI realiza una llamada al método IWbemProviderInit::QueryInterface en el proveedor. Esta consulta recupera un puntero a la interfaz principal del proveedor.
En el procedimiento siguiente se describe cómo notificar un error durante la inicialización.
Para notificar un error durante la inicialización
Establezca el parámetro IStatus de SetStatus en WBEM_E_FAILED. Proveedores de vistas de WMI que devuelven WBEM_E_FAILED cuando no funcionan.
WMI libera el puntero IWbemProviderInit después de que WMI haya obtenido un puntero a la interfaz principal del proveedor o después de que se haya producido un error en la inicialización.
Temas relacionados