__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

資料類型: 字串

存取類型:讀取/寫入

GUID ,表示提供者 COM 物件的 CLSID) (類別識別碼。 這個 COM 物件必須包含 IWbemProviderInit 介面的實作。

並行

資料類型: sint32

存取類型:讀取/寫入

未使用。

DefaultMachineName

資料類型: 字串

存取類型:讀取/寫入

識別要啟動提供者的電腦。 如果提供者在本機電腦上執行,則為 Null

Enabled

資料類型: 布林值

存取類型:讀取/寫入

如果為 TRUE,則會啟用此實例,而且可用來完成用戶端要求。

HostingModel

資料類型: 字串

存取類型:讀取/寫入

這個屬性是由hostingGroupHostingSpecification屬性MSFT_Providers的值所組成。 此屬性的值會指定 WMI 如何載入提供者及其執行的安全性帳戶。 如需設定 HostingModel 屬性的詳細資訊,請參閱 Provider Hosting and Security and Registering a Provider

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來準備卸載。 在 WMI 的用戶端無法運作之後,必須保持為 WMI 的提供者,應該將 Pure 設定為 FALSE。 預設設定為 TRUE。 如需詳細資訊,請參閱本主題的一節。

SecurityDescriptor

資料類型: 字串

存取類型:讀取/寫入

安全性描述項 (SD) 在安全性描述元定義語言 (SDDL) 中決定可成功呼叫 IWbemDecoupledRegistrar:Register 給分離提供者的使用者集。 如需詳細資訊,請參閱 Windows SDK 安全性一節的安全性 描述項定義語言 主題。 此安全性描述項僅用於分離提供者,而且不會影響其他提供者。 如需詳細資訊,請參閱 在應用程式中納入提供者

WMI 會針對使用 IWbemProviderInitIWbemObjectSink 介面的分離提供者執行存取檢查。 如果安全性描述項為 Null,則只有在 LocalSystem、NetworkService、LocalService 帳戶下執行的應用程式或服務可以執行分離的提供者。

下列字串顯示僅由內建 Administrators 執行的分離提供者。」O:BAG:BAD: (A;;0x1;;;BA) 」

如需設定 SecurityDescriptor 屬性的詳細資訊,請參閱 維護 WMI 安全性

SupportsExplicitShutdown

資料類型: 布林值

存取類型:讀取/寫入

未使用。

SupportsExtendedStatus

資料類型: 布林值

存取類型:讀取/寫入

未使用。

SupportsQuotas

資料類型: 布林值

存取類型:讀取/寫入

未使用。

SupportsSendStatus

資料類型: 布林值

存取類型:讀取/寫入

未使用。

SupportsShutdown

資料類型: 布林值

存取類型:讀取/寫入

未使用。

SupportsThrottling

資料類型: 布林值

存取類型:讀取/寫入

未使用。

UnloadTimeout

資料類型: datetime

存取類型:讀取/寫入

指定 WMI 允許提供者在卸載之前保持閒置的日期和時間格式。 一般而言,提供者會要求 WMI 等候不超過五分鐘。

針對目前的 WMI 版本,會忽略此屬性的值。 WMI 會根據 \root 命名空間內部類別中的逾時值來卸載提供者。 建議提供者設定 UnloadTimeout。 如需詳細資訊,請參閱 卸載提供者

版本

資料類型: uint32

存取類型:讀取/寫入

提供者的版本。 支援的版本為 1 和 2。 第 2 版會強化所有相關聯屬性註冊的有效性檢查,特別是 ImpersonationLevel 屬性。

備註

__Win32Provider類別衍生自__Provider

大部分提供者都可以接受 InitializationReentrancy 屬性的預設值。 不過,如果提供者可以支援個別使用者的同時初始化,此屬性可以設定為 1 (一個) 。 如果需要序列化初始化, InitializationReentrancy 會維持 0 (零) 。 在這兩個實例中, PerUserInitialization 會設定為 TRUE

純提供者或將 Pure 屬性設定為 TRUE的提供者,只存在於來自應用程式和 WMI 的服務要求。 大部分的提供者都是純提供者。 非Pure 提供者是例外狀況。 非Pure 提供者會在完成服務要求之後轉換至用戶端的角色。

非Pure 提供者的範例是一個推送提供者,它會開始發出查詢,並在 WMI 完成初始化之後提出要求。 除非在初始化時使用資料更新 CIM 存放庫,否則推播提供者沒有責任。 更新存放庫之後,推送提供者可以等候卸載,或轉換至用戶端的角色。 等候卸載的推送提供者是純提供者。 參與用戶端活動的推送提供者是非Pure 的。

WMI 必須能夠區分純提供者與非純純提供者,以便判斷何時可以安全關機。 WMI 必須等候涉及非純純提供者的所有作業完成,才能安全地關閉。

規格需求

需求
最低支援的用戶端
Windows Vista
最低支援的伺服器
Windows Server 2008
命名空間
所有 WMI 命名空間

另請參閱

__供應商

WMI 系統類別

註冊提供者