__Win32Provider clase
La clase del sistema __Win32Provider registra información sobre la implementación física de un proveedor en WMI. Los proveedores que no establecen la propiedad HostingModel se cargan de forma predeterminada 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 muestran en orden alfabético, no en orden 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 y 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 al cliente mediante ClientLoadableCLSID como identificador de clase. Cuando el proveedor y el cliente se encuentran en equipos diferentes, WMI carga el proveedor en proceso en WMI. WMI también usa ClientLoadableCLSID para admitir operaciones de actualización.
Para obtener más información, consulte Registro de un proveedor de High-Performance.
-
-
CLSID
-
-
Tipo de datos: cadena
-
Tipo de acceso: lectura y 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 y escritura
No se usa.
-
-
DefaultMachineName
-
-
Tipo de datos: cadena
-
Tipo de acceso: lectura y 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 y escritura
Si es TRUE, esta instancia está habilitada y se puede usar para completar las solicitudes de cliente.
-
-
HostingModel
-
-
Tipo de datos: cadena
-
Tipo de acceso: lectura y escritura
Esta propiedad se compone de 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 obtener más información sobre cómo establecer la propiedad HostingModel , vea Provider Hosting and Security andRegistering a Provider.
-
-
ImpersonationLevel
-
-
Tipo de datos: sint32
-
Tipo de acceso: lectura y escritura
Reservado. El valor predeterminado es cero (0).
-
-
InitializationReentrancy
-
-
Tipo de datos: sint32
-
Tipo de acceso: lectura y 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
-
Todas las inicializaciones de este proveedor en el mismo espacio de nombres deben serializarse.
-
2
-
No es necesaria ninguna serialización de inicialización.
InitializationTimeoutInterval
-
Tipo de datos: datetime
-
Tipo de acceso: lectura y escritura
No se usa.
InitializeAsAdminFirst
-
Tipo de datos: booleano
-
Tipo de acceso: lectura y escritura
TBD
Nombre
-
Tipo de datos: cadena
-
Tipo de acceso: lectura y escritura
-
Calificadores: Clave
Nombre del proveedor.
OperationTimeoutInterval
-
Tipo de datos: datetime
-
Tipo de acceso: lectura y escritura
No se usa.
PerLocaleInitialization
-
Tipo de datos: booleano
-
Tipo de acceso: lectura y 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 mediante configuraciones regionales diferentes. El valor predeterminado es FALSE.
PerUserInitialization
-
Tipo de datos: booleano
-
Tipo de acceso: lectura y 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 y escritura
Si es TRUE, el proveedor acepta prepararse para descargar llamando 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 permanecer como clientes de WMI después de que no funcionen como proveedores deben establecer Pure en FALSE. El valor predeterminado es TRUE. Para obtener más información, vea la sección Comentarios de este tema.
SecurityDescriptor
-
Tipo de datos: cadena
-
Tipo de acceso: lectura y 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 obtener más información, consulte el tema Security Descriptor Definition Language (Lenguaje de definición de descriptores de seguridad) en la sección Seguridad del SDK de Windows. Este descriptor de seguridad solo se usa para proveedores desacoplados y no afecta a otros proveedores. Para obtener 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 localSystem, NetworkService, las cuentas de LocalService pueden ejecutar un proveedor desacoplado.
En la cadena siguiente se muestra un proveedor desacoplado que solo se ejecutará mediante administradores integrados". O:BAG:BAD:(A;;0 x1;;;; BA)"
Para obtener más información sobre cómo establecer la propiedad SecurityDescriptor , vea Mantenimiento de la seguridad de WMI.
SupportsExplicitShutdown
-
Tipo de datos: booleano
-
Tipo de acceso: lectura y escritura
No se usa.
SupportsExtendedStatus
-
Tipo de datos: booleano
-
Tipo de acceso: lectura y escritura
No se usa.
SupportsQuotas
-
Tipo de datos: booleano
-
Tipo de acceso: lectura y escritura
No se usa.
SupportsSendStatus
-
Tipo de datos: booleano
-
Tipo de acceso: lectura y escritura
No se usa.
SupportsShutdown
-
Tipo de datos: booleano
-
Tipo de acceso: lectura y escritura
No se usa.
SupportsThrottling
-
Tipo de datos: booleano
-
Tipo de acceso: lectura y escritura
No se usa.
UnloadTimeout
-
Tipo de datos: datetime
-
Tipo de acceso: lectura y escritura
Formato de fecha y hora que especifica cuánto tiempo permite que WMI permanezca inactivo antes de que se descargue. Normalmente, los proveedores solicitan que WMI espere más de cinco minutos.
Para 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 UnloadTimeout. Para obtener más información, consulte Descarga de un proveedor.
Versión
-
Tipo de datos: uint32
-
Tipo de acceso: lectura y escritura
Versión del proveedor. Las versiones admitidas 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 .
Observaciones
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 para usuarios independientes, esta propiedad se puede establecer en 1 (una). Si es necesaria 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 atender solicitudes de aplicaciones y WMI. La mayoría de los proveedores son proveedores puros. Un proveedor que no es depure es la excepción. Los proveedores que no son depure pasan al rol de cliente después de completar las solicitudes de mantenimiento.
Un ejemplo de un proveedor que no es depure es un proveedor de inserción que comienza a emitir consultas y realiza solicitudes de WMI una vez completada la inicialización. Un proveedor de inserción no tiene responsabilidades, excepto para 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 realizar la transición al rol de cliente. El proveedor de inserción que espera a descargarse es un proveedor puro. El proveedor de inserción que participa en las actividades de cliente no espure.
WMI debe ser capaz de distinguir proveedores puros de proveedores no puros para que pueda determinar cuándo es seguro apagarse. WMI debe esperar a que todas las operaciones que impliquen proveedores no puros se completen antes de que pueda apagarse de forma 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 |