Método IWbemProviderInit::Initialize (wbemprov.h)
Windows Management llama al método IWbemProviderInit::Initialize para inicializar un proveedor para recibir solicitudes de cliente. Todos los tipos de proveedores deben implementar este método.
Sintaxis
HRESULT Initialize(
[in] LPWSTR wszUser,
[in] LONG lFlags,
[in] LPWSTR wszNamespace,
[in] LPWSTR wszLocale,
[in] IWbemServices *pNamespace,
[in] IWbemContext *pCtx,
[in] IWbemProviderInitSink *pInitSink
);
Parámetros
[in] wszUser
Puntero al nombre de usuario, si se solicitó la inicialización por usuario en la instancia de registro de __Win32Provider para este proveedor. De lo contrario, es NULL.
Tenga en cuenta que este parámetro se establece en NULL para los proveedores de consumidores de eventos, independientemente del valor de la propiedad PerUserInitialization en la instancia de __Win32Provider para el proveedor.
[in] lFlags
Reservado. Este parámetro debe ser 0 (cero).
[in] wszNamespace
Un nombre de espacio de nombres para el que se inicializa el proveedor.
[in] wszLocale
Nombre de configuración regional para el que se inicializa el proveedor.
Cadena con el siguiente formato, donde el valor hexadecimal es un valor LCID estándar de Microsoft:
- "MS_409"
[in] pNamespace
Puntero IWbemServices a Administración de Windows. Este puntero puede atender las solicitudes realizadas por el proveedor. El proveedor debe usar el método IWbemProviderInit::AddRef en este puntero si va a volver a llamar a Windows Management durante su ejecución.
[in] pCtx
Puntero IWbemContext asociado a la inicialización. Este parámetro puede ser NULL.
Si el proveedor volverá a realizar solicitudes en administración de Windows antes de completar la inicialización, debe usar el método IWbemProviderInit::AddRef en este puntero. Para más información, consulte Llamadas a WMI.
En caso de que un proveedor deba realizar una solicitud dependiente en otro proveedor, debe volver a pasar esta cadena de contexto a WMI para evitar posibles bloqueos. Sin embargo, en el caso de una solicitud independiente, esto no es necesario y WMI genera una nueva cadena de contexto para ella.
[in] pInitSink
Puntero IWbemProviderInitSink que usa el proveedor para notificar el estado de inicialización.
Valor devuelto
El proveedor debe devolver WBEM_S_NO_ERROR e indicar su estado mediante el receptor de objetos proporcionado en el parámetro pInitSink . Sin embargo, si un proveedor devuelve WBEM_E_FAILED y no usa el receptor, la inicialización del proveedor se considera errónea.
Comentarios
Normalmente, el proveedor implementa un objeto COM mediante la herencia múltiple para admitir la interfaz IWbemProviderInit , así como su interfaz principal, como IWbemServices o IWbemEventProvider.
El estado de inicialización se notifica mediante una llamada a IWbemProviderInitSink::SetStatus. Se puede llamar a este método repetidamente para notificar el estado incremental si es necesario. El proveedor debe incrementar el recuento de referencias en este puntero llamando a su método IWbemProviderInit::AddRef antes de usarlo para comunicar el estado a La administración de Windows.
El proveedor puede usar el puntero IWbemProviderInitSink de forma sincrónica, como en el ejemplo de código siguiente.
HRESULT SampleProvider::Initialize(
/* [unique][in] */ LPWSTR wszUser,
/* [in] */ LONG lFlags,
/* [in] */ LPWSTR wszNamespace,
/* [unique][in] */ LPWSTR wszLocale,
/* [in] */ IWbemServices __RPC_FAR *pNamespace,
/* [in] */ IWbemContext __RPC_FAR *pCtx,
/* [in] */ IWbemProviderInitSink __RPC_FAR *pInitSink
)
{
// Use AddRef on the pNamespace pointer, if required.
// Analyze other parameters.
// Tell Windows Management that you are initialized.
pInitSink->SetStatus(WBEM_S_INITIALIZED, 0);
return WBEM_S_NO_ERROR;
}
El proveedor también puede usar el método AddRef en el puntero y crear un subproceso independiente para completar su inicialización y devolver inmediatamente de la llamada.
El proceso de inicialización de algunos proveedores puede implicar volver a llamar a WMI. Un proveedor que llama de nuevo a WMI y debe esperar a que se complete esa llamada se denomina proveedor dependiente. De forma similar, una llamada a WMI se denomina solicitud dependiente. Al implementar Initialize, WMI requiere que un proveedor dependiente cumpla las reglas siguientes:
-
Las solicitudes dependientes deben reutilizar el puntero IWbemContext que WMI pasó a Initialize.
Esto significa que cualquier llamada a WMI realizada durante la inicialización debe reutilizar el puntero IWbemContext que WMI pasó. Si no lo hace, se puede producir un interbloqueo.
- Las solicitudes no dependientes no deben reutilizar el puntero IWbemContext .
-
Los proveedores dependientes deben realizar solicitudes a WMI mediante una de las dos estrategias siguientes:
- Realice solicitudes dependientes con el subproceso recibido de WMI.
- Realice solicitudes dependientes con un nuevo subproceso creado por el proveedor.
- Todos los proveedores deben devolver el subproceso recibido de WMI.
-
En ninguna circunstancia, WMI permite que un proveedor bloquee un subproceso recibido de WMI.
El peligro de no controlar cuidadosamente los subprocesos entregados por WMI es que un proveedor puede adquirir todos los subprocesos del grupo de subprocesos WMI y continuar bloqueando esos subprocesos. Esto daría lugar a un sistema interbloqueo.
En el ejemplo de código siguiente se describe cómo usar el identificador de CLSID_WbemAdministrativeLocator en dicha llamada.
IWbemLocator *pLoc = 0;
DWORD dwRes = CoCreateInstance(CLSID_WbemAdministrativeLocator, 0,
CLSCTX_INPROC_SERVER, IID_IWbemLocator, (LPVOID *) &pLoc);
Si no se usa el identificador de CLSID_WbemAdministrativeLocator , se produce un error de acceso denegado. Para obtener más información sobre cómo realizar una conexión a WMI, vea Creating a WMI Application or Script.
Ejemplos
En el ejemplo de código siguiente se describe cómo implementar Initialize para un proveedor de consumidores de eventos.
HRESULT CMyEventConsumer::Initialize(
/* [in] */ LPWSTR pszUser,
/* [in] */ LONG lFlags,
/* [in] */ LPWSTR pszNamespace,
/* [in] */ LPWSTR pszLocale,
/* [in] */ IWbemServices __RPC_FAR *pNamespace,
/* [in] */ IWbemContext __RPC_FAR *pCtx,
/* [in] */ IWbemProviderInitSink __RPC_FAR *pInitSink
)
{
pInitSink->SetStatus(WBEM_S_INITIALIZED, 0);
// Optionally, examine the namespace, locale, and so on
// being used.
return WBEM_S_NO_ERROR;
}
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | wbemprov.h (include Wbemidl.h) |
| Library | Wbemuuid.lib |
| Archivo DLL | Wbemsvc.dll |
Consulte también
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de