__Win32Provider 类

_ _ Win32Provider 系统类在 WMI 中注册有关提供程序的物理实现的信息。 默认情况下,将加载未设置 HostingModel 属性的提供程序,作为 NetworkServiceHostOrSelfHost 在 Wmiprvse.exe 进程中运行。

以下语法从托管对象格式 (MOF) 代码简化而来,包括所有继承属性。 属性按字母顺序列出,而不是按 MOF 顺序列出。

语法

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;
};

成员

_ _ Win32Provider 类具有以下类型的成员:

属性

_ _ Win32Provider 类具有以下属性。

ClientLoadableCLSID

数据类型: 字符串

访问类型:读/写

WMI 用来确定是否将高性能提供程序加载到客户端进程或 WMI 进程中的类标识符。 如果提供程序和客户端都位于同一台计算机上,WMI 将使用 ClientLoadableCLSID 作为类标识符将提供程序进程中的提供程序加载到客户端。 当提供程序和客户端位于不同的计算机上时,WMI 会将提供程序从进程中加载到 WMI。 WMI 还使用 ClientLoadableCLSID 来支持刷新操作。

有关详细信息,请参阅 注册 High-Performance 提供程序。

CLSID

数据类型: 字符串

访问类型:读/写

表示提供程序 COM 对象的 CLSID) (类标识符的 GUID 。 此 COM 对象必须包含 IWbemProviderInit 接口的实现。

并发

数据类型: sint32

访问类型:读/写

未使用。

DefaultMachineName

数据类型: 字符串

访问类型:读/写

标识要在其上启动该提供程序的计算机。 如果提供程序在本地计算机上运行,则为 NULL

Enabled

数据类型: 布尔值

访问类型:读/写

如果 为 TRUE,则启用此实例并可用于完成客户端请求。

HostingModel

数据类型: 字符串

访问类型:读/写

此属性由 MSFT _ 提供程序 HostingGroupHostingSpecification 属性中的值组成。 此属性的值指定 WMI 如何加载提供程序以及它运行时所用的安全帐户。 有关设置 HostingModel 属性的详细信息,请参阅 提供程序托管和安全性注册提供程序

ImpersonationLevel

数据类型: sint32

访问类型:读/写

保留。 默认值为零 (0)。

InitializationReentrancy

数据类型: sint32

访问类型:读/写

提供有关序列化信息的标志集。 默认值为零 (0)。

0

此提供程序的所有初始化都必须进行序列化。

1

此提供程序在同一命名空间中的所有初始化都必须进行序列化。

2

不需要初始化序列化。

InitializationTimeoutInterval

数据类型: datetime

访问类型:读/写

未使用。

InitializeAsAdminFirst

数据类型: 布尔值

访问类型:读/写

TBD

名称

数据类型: 字符串

访问类型:读/写

限定符:

提供程序名称。

OperationTimeoutInterval

数据类型: datetime

访问类型:读/写

未使用。

PerLocaleInitialization

数据类型: 布尔值

访问类型:读/写

如果 为 TRUE,则当用户使用不同的区域设置多次连接到同一个命名空间时,将为每个区域设置初始化提供程序。 默认值为 FALSE

PerUserInitialization

数据类型: 布尔值

访问类型:读/写

如果 为 TRUE,则为每个 NT LAN Manager 初始化一次提供程序, (NTLM) 用户向提供程序发出请求。 如果 为 FALSE (默认值) ,则为所有用户初始化一次访问接口。

数据类型: 布尔值

访问类型:读/写

如果 为 TRUE,则当 WMI 调用其主接口的 Release 方法时,该提供程序同意通过在所有未完成的接口点上调用 IUnknown:: release来准备卸载。 如果访问接口不能作为提供程序的客户端,则必须保持其客户端的访问接口应将 设置为 FALSE。 默认设置为 TRUE。 有关详细信息,请参阅本主题的 "备注" 部分。

SecurityDescriptor

数据类型: 字符串

访问类型:读/写

安全描述符定义语言中 (SD) 的安全描述符定义语言 (SDDL) ,它确定可成功调用 IWbemDecoupledRegistrar 的用户集。 有关详细信息,请参阅 Windows SDK 的 "安全" 部分中的 安全描述符定义语言 主题。 此安全描述符仅用于分离的提供程序,并且不会影响其他提供程序。 有关详细信息,请参阅 在应用程序中合并提供程序

WMI 会对使用 IWbemProviderInitIWbemObjectSink 接口的分离式提供程序执行访问检查。 如果安全描述符为 NULL,则只有在 LocalSystem、NetworkService、LocalService 帐户下运行的应用程序或服务才能运行分离的访问接口。

下面的字符串显示一个分离的提供程序,仅供内置管理员运行。 "O:BAG:错误: (A;; 0x1;;;BA) "

有关设置 SecurityDescriptor 属性的详细信息,请参阅 维护 WMI 安全性

SupportsExplicitShutdown

数据类型: 布尔值

访问类型:读/写

未使用。

SupportsExtendedStatus

数据类型: 布尔值

访问类型:读/写

未使用。

SupportsQuotas

数据类型: 布尔值

访问类型:读/写

未使用。

SupportsSendStatus

数据类型: 布尔值

访问类型:读/写

未使用。

SupportsShutdown

数据类型: 布尔值

访问类型:读/写

未使用。

SupportsThrottling

数据类型: 布尔值

访问类型:读/写

未使用。

UnloadTimeout

数据类型: datetime

访问类型:读/写

日期和时间格式 ,指定 WMI 允许提供程序在卸载之前处于空闲状态的时间长度。 通常,提供程序请求 WMI 等待时间不超过五分钟。

对于当前版本的 WMI,将忽略此属性的值。 WMI 基于根命名空间内部类中的超时值卸载提供程序 \ 。 建议提供程序设置 UnloadTimeout。 有关详细信息,请参阅 卸载提供程序

版本

数据类型: uint32

访问类型:读/写

提供程序的版本。 支持的版本为1和2。 版本2将为所有关联的属性注册(特别是 ImpersonationLevel 属性)增强有效性检查。

备注

_ _ Win32Provider 类派生自 _ _ 提供程序

大多数提供程序都可以接受 InitializationReentrancy 属性的默认值。 但是,如果提供程序可以支持对不同用户同时进行初始化,则可以将此属性设置为1, (一个) 。 如果需要序列化初始化, InitializationReentrancy 将保持 0 (零) 。 在这两个实例中, PerUserInitialization 设置为 TRUE

属性设置为 TRUE 的纯提供程序或提供程序仅存在于来自应用程序和 WMI 的服务请求。 大多数提供程序都是纯提供程序。 Nonpure 提供程序是个例外。 Nonpure 提供程序在完成服务请求后,将转换为客户端的角色。

Nonpure 提供程序的一个示例是一个推送提供程序,该提供程序开始发出查询并在完成初始化后发出 WMI 请求。 推送提供程序没有责任,只是在初始化时使用数据更新 CIM 存储库。 更新存储库后,推送提供程序可以等待卸载,或转换为客户端的角色。 等待卸载的推送提供程序是纯访问接口。 参与客户端活动的推送提供程序是 nonpure。

WMI 必须能够区分纯提供程序和非纯提供程序,以便它可以确定何时可以安全关闭。 WMI 必须等待所有涉及非纯提供程序的操作完成,然后才能安全关闭。

要求

要求
最低受支持的客户端
Windows Vista
最低受支持的服务器
Windows Server 2008
命名空间
所有 WMI 命名空间

另请参阅

__提供程序

WMI 系统类

注册提供程序