Clase __Win32Provider
La clase __Win32Provider del sistema registra información sobre la implementación física de un proveedor en WMI. De manera predeterminada, los proveedores que no establecen la propiedad HostingModel se cargan para ejecutarse en un proceso de Wmiprvse.exe como NetworkServiceHostOrSelfHost.
La siguiente sintaxis se simplifica desde el código de Managed Object Format (MOF) e incluye todas las propiedades heredadas. Las propiedades se indican en orden alfabético, no en orden de MOF.
Sintaxis
class __Win32Provider : __Provider
{
string ClientLoadableCLSID;
string CLSID;
sint32 Concurrency;
string DefaultMachineName;
boolean Enabled;
string HostingModel;
sint32 ImpersonationLevel = 0;
sint32 InitializationReentrancy;
datetime InitializationTimeoutInterval;
boolean InitializeAsAdminFirst;
string Name;
datetime OperationTimeoutInterval;
boolean PerLocaleInitialization = FALSE;
boolean PerUserInitialization = FALSE;
boolean Pure = TRUE;
string SecurityDescriptor;
boolean SupportsExplicitShutdown;
boolean SupportsExtendedStatus;
boolean SupportsQuotas;
boolean SupportsSendStatus;
boolean SupportsShutdown;
boolean SupportsThrottling;
datetime UnloadTimeout;
uint32 Version;
};
Miembros
La clase __Win32Provider tiene estos tipos de miembros:
Propiedades
La clase __Win32Provider tiene estas propiedades.
-
ClientLoadableCLSID
-
-
Tipo de datos: cadena
-
Tipo de acceso: lectura/escritura
Identificador de clase que WMI usa para determinar si se va a cargar o no un proveedor de alto rendimiento en el proceso de cliente o en el proceso de WMI. Si el proveedor y el cliente se encuentran en el mismo equipo, WMI carga el proveedor en proceso en el cliente con ClientLoadableCLSID como identificador de clase. Cuando el proveedor y el cliente se encuentran en equipos distintos, WMI carga el proveedor en proceso en WMI. WMI también usa ClientLoadableCLSID para admitir operaciones de actualización.
Para más información, consulte Registro de un proveedor de alto rendimiento.
-
-
CLSID
-
-
Tipo de datos: cadena
-
Tipo de acceso: lectura/escritura
GUID que representa el identificador de clase (CLSID) del objeto COM del proveedor. Este objeto COM debe contener una implementación de la interfaz IWbemProviderInit.
-
-
Concurrency
-
-
Tipo de datos: sint32
-
Tipo de acceso: lectura/escritura
No se usa.
-
-
DefaultMachineName
-
-
Tipo de datos: cadena
-
Tipo de acceso: lectura/escritura
Identifica el equipo en el que se va a iniciar el proveedor. Si el proveedor se ejecuta en el equipo local, es NULL.
-
-
Enabled
-
-
Tipo de datos: booleano
-
Tipo de acceso: lectura/escritura
Si es TRUE, esta instancia está habilitada y se puede usar para completar solicitudes de cliente.
-
-
HostingModel
-
-
Tipo de datos: cadena
-
Tipo de acceso: lectura/escritura
Esta propiedad consta de los valores de las propiedades MSFT_ProvidersHostingGroup y HostingSpecification. El valor de esta propiedad especifica cómo WMI carga el proveedor y la cuenta de seguridad en la que se ejecuta. Para más información sobre cómo establecer la propiedad HostingModel, consulte Hospedaje y seguridad del proveedor y Registro de un proveedor.
-
-
ImpersonationLevel
-
-
Tipo de datos: sint32
-
Tipo de acceso: lectura/escritura
Reservado. El valor predeterminado es cero (0).
-
-
InitializationReentrancy
-
-
Tipo de datos: sint32
-
Tipo de acceso: lectura/escritura
Conjunto de marcas que proporcionan información sobre la serialización. El valor predeterminado es cero (0).
-
-
0
-
Se deben serializar todas las inicializaciones de este proveedor.
-
1
-
Se deben serializar todas las inicializaciones de este proveedor en el mismo espacio de nombres.
-
2
-
No es necesario serializar ninguna inicialización.
InitializationTimeoutInterval
-
Tipo de datos: fecha/hora
-
Tipo de acceso: lectura/escritura
No se usa.
InitializeAsAdminFirst
-
Tipo de datos: booleano
-
Tipo de acceso: lectura/escritura
TBD
Nombre
-
Tipo de datos: cadena
-
Tipo de acceso: lectura/escritura
-
Calificadores: Key
Nombre del proveedor.
OperationTimeoutInterval
-
Tipo de datos: fecha/hora
-
Tipo de acceso: lectura/escritura
No se usa.
PerLocaleInitialization
-
Tipo de datos: booleano
-
Tipo de acceso: lectura/escritura
Si es TRUE, el proveedor se inicializa para cada configuración regional cuando un usuario se conecta al mismo espacio de nombres más de una vez con configuraciones regionales diferentes. El valor predeterminado es FALSE.
PerUserInitialization
-
Tipo de datos: booleano
-
Tipo de acceso: lectura/escritura
Si es TRUE, el proveedor se inicializa una vez para cada usuario de NT LAN Manager (NTLM) que realiza solicitudes al proveedor. Si es FALSE (valor predeterminado), el proveedor se inicializa una vez para todos los usuarios.
Pura
-
Tipo de datos: booleano
-
Tipo de acceso: lectura/escritura
Si es TRUE, el proveedor acepta prepararse para la descarga mediante una llamada a IUnknown::Release en todos los puntos de interfaz pendientes cuando WMI llama al método Release de su interfaz principal. Los proveedores que deben seguir como clientes de WMI después de no funcionar como proveedores debe establecer Pure en FALSE. El valor de configuración predeterminado es TRUE. Para más información, consulte la sección Observaciones en este tema.
SecurityDescriptor
-
Tipo de datos: cadena
-
Tipo de acceso: lectura/escritura
Descriptor de seguridad (SD) en el Lenguaje de definición de descriptor de seguridad (SDDL) que determina el conjunto de usuarios que pueden llamar correctamente a IWbemDecoupledRegistrar:Register para el proveedor desacoplado. Para más información, consulte el tema Lenguaje de definición de descriptor de seguridad en la sección Seguridad de Windows SDK. Este descriptor de seguridad solo se usa para los proveedores desacoplados y no afecta a otros proveedores. Para más información, consulte Incorporación de un proveedor en una aplicación.
WMI realiza comprobaciones de acceso para proveedores desacoplados que usan las interfaces IWbemProviderInit e IWbemObjectSink. Si el descriptor de seguridad es NULL, solo las aplicaciones o servicios que se ejecutan en las cuentas de LocalSystem, NetworkService y LocalService pueden ejecutar un proveedor desacoplado.
En la cadena siguiente, se muestra un proveedor desacoplado que solo van a ejecutar las cuentas predefinidas de administrador."O:BAG:BAD:(A;;0x1;;;BA)"
Para más información sobre cómo establecer la propiedad SecurityDescriptor, consulte Mantenimiento de la seguridad de WMI.
SupportsExplicitShutdown
-
Tipo de datos: booleano
-
Tipo de acceso: lectura/escritura
No se usa.
SupportsExtendedStatus
-
Tipo de datos: booleano
-
Tipo de acceso: lectura/escritura
No se usa.
SupportsQuotas
-
Tipo de datos: booleano
-
Tipo de acceso: lectura/escritura
No se usa.
SupportsSendStatus
-
Tipo de datos: booleano
-
Tipo de acceso: lectura/escritura
No se usa.
SupportsShutdown
-
Tipo de datos: booleano
-
Tipo de acceso: lectura/escritura
No se usa.
SupportsThrottling
-
Tipo de datos: booleano
-
Tipo de acceso: lectura/escritura
No se usa.
UnloadTimeout
-
Tipo de datos: fecha/hora
-
Tipo de acceso: lectura/escritura
Formato de fecha y hora que especifica durante cuánto tiempo WMI permite que el proveedor permanezca inactivo antes de que se descargue. Por lo general, los proveedores solicitan que WMI espere más de cinco minutos.
En la versión actual de WMI, se omite el valor de esta propiedad. WMI descarga el proveedor en función del valor de tiempo de espera de una clase interna en el espacio de nombres \root. Se recomienda que los proveedores establezcan el valor UnloadTimeout. Para más información, consulte Descarga de un proveedor.
Versión
-
Tipo de datos: uint32
-
Tipo de acceso: lectura/escritura
Versión del proveedor. Las versiones compatibles son 1 y 2. La versión 2 refuerza las comprobaciones de validez de todos los registros de propiedad asociados, específicamente la propiedad ImpersonationLevel.
Comentarios
La clase __Win32Provider se deriva de __Provider.
La mayoría de los proveedores pueden aceptar los valores predeterminados para la propiedad InitializationReentrancy. Sin embargo, si un proveedor puede admitir la inicialización simultánea de usuarios independientes, esta propiedad se puede establecer en 1 (uno). Si se necesita la inicialización serializada, InitializationReentrancy sigue siendo 0 (cero). En ambas instancias, PerUserInitialization se establece en TRUE.
Un proveedor puro o un proveedor que establece la propiedad Pure en TRUE solo existe para las solicitudes de servicio y WMI. La mayoría de los proveedores son proveedores puros. Un proveedor que no es puro es la excepción. Los proveedores que no son puros pasan al rol de cliente después de completar las solicitudes de servicio.
Un ejemplo de proveedor no puro es un proveedor de inserción que comienza a emitir consultas y hace solicitudes de WMI una vez que se completa la inicialización. Un proveedor de inserción no tiene responsabilidades, excepto la de actualizar el repositorio CIM con datos en el momento de la inicialización. Después de actualizar el repositorio, un proveedor de inserción puede esperar a descargarse, o bien realizar la transición al rol de cliente. El proveedor de inserción que espera su descarga es un proveedor puro. El proveedor de inserción que participa en las actividades de cliente no es puro.
WMI debe ser capaz de distinguir entre los proveedores puros y los que no son no puros para poder determinar cuándo es seguro apagarse. WMI debe esperar a que todas las operaciones que impliquen a proveedores no puros se completen antes de que se pueda apagar de manera segura.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible |
Windows Vista |
Servidor mínimo compatible |
Windows Server 2008 |
Espacio de nombres |
Todos los espacios de nombres WMI |