Clase __Win32Provider

  • Artículo

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

Consulte también

__Provider

Clases del sistema WMI

Registro de un proveedor