__Win32Provider 类

项目
06/29/2023

__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 来支持刷新操作。

有关详细信息，请参阅注册高性能提供程序。

CLSID

数据类型：字符串
访问类型：读/写

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

并发

数据类型：sint32
访问类型：读/写

未使用。

DefaultMachineName

数据类型：字符串
访问类型：读/写

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

已启用

数据类型：布尔值
访问类型：读/写

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

HostingModel

数据类型：字符串
访问类型：读/写

此属性由 MSFT_Providers HostingGroup 和 HostingSpecification 属性的值组成。此属性的值指定 WMI 如何加载提供程序以及用于运行提供程序的安全帐户。有关设置 HostingModel 属性的详细信息，请参阅提供程序托管和安全性和注册提供程序。

ImpersonationLevel

数据类型：sint32
访问类型：读/写

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

InitializationReentrancy

数据类型：sint32
访问类型：读/写

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

0

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

1

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

2

无需进行初始化序列化。

InitializationTimeoutInterval

数据类型：日期/时间
访问类型：读/写

未使用。

InitializeAsAdminFirst

数据类型：布尔值
访问类型：读/写

TBD

名称

数据类型：字符串
访问类型：读/写
限定符：Key

提供程序名称。

OperationTimeoutInterval

数据类型：日期/时间
访问类型：读/写

未使用。

PerLocaleInitialization

数据类型：布尔值
访问类型：读/写

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

PerUserInitialization

数据类型：布尔值
访问类型：读/写

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

纯

数据类型：布尔值
访问类型：读/写

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

SecurityDescriptor

数据类型：字符串
访问类型：读/写

安全描述符定义语言 (SDDL) 中的安全描述符 (SD)，用于确定哪一组用户可以针对分离式提供程序成功调用 IWbemDecoupledRegistrar:Register。有关详细信息，请参阅 Windows SDK“安全性”部分中的安全描述符定义语言主题。此安全描述符仅用于分离式提供程序，而不影响其他提供程序。有关详细信息，请参阅在应用程序中合并提供程序。

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

以下字符串显示了一个只能由内置管理员运行的分离式提供程序。"O:BAG:BAD:(A;;0x1;;;BA)"

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

SupportsExplicitShutdown

数据类型：布尔值
访问类型：读/写

未使用。

SupportsExtendedStatus

数据类型：布尔值
访问类型：读/写

未使用。

SupportsQuotas

数据类型：布尔值
访问类型：读/写

未使用。

SupportsSendStatus

数据类型：布尔值
访问类型：读/写

未使用。

SupportsShutdown

数据类型：布尔值
访问类型：读/写

未使用。

SupportsThrottling

数据类型：布尔值
访问类型：读/写

未使用。

UnloadTimeout

数据类型：日期/时间
访问类型：读/写

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

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

Version

数据类型：uint32
访问类型：读/写

提供程序的版本。支持的版本为 1 和 2。版本 2 增强了对所有关联属性注册（具体而言是 ImpersonationLevel 属性）的有效性检查。

备注

__Win32Provider 类派生自 __Provider。

大多数提供程序可以接受 InitializationReentrancy 属性的默认值。但是，如果提供程序可以支持不同用户的同时初始化，则可以将此属性设置为 1（一）。如果需要序列化初始化，InitializationReentrancy 将保持为 0（零）。在这两种情况下，PerUserInitialization 都设置为 TRUE。

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

非纯提供程序的一个示例是先发出查询，然后在完成初始化后发出 WMI 请求的推送提供程序。推送提供程序只需在初始化时使用数据更新 CIM 存储库，此外没有其他责任。更新存储库后，推送提供程序可以等待卸载，或转换为客户端的角色。等待卸载的推送提供程序是纯提供程序。参与客户端活动的推送提供程序是非纯提供程序。

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

要求

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

另请参阅

__Provider
WMI 系统类
注册提供程序

通过

__Win32Provider 类

语法

成员

属性

备注

要求

另请参阅

反馈

其他资源