__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
-
-
資料類型: 字串
-
存取類型:讀取/寫入
這個屬性是由hostingGroup和HostingSpecification屬性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 會針對使用 IWbemProviderInit 和 IWbemObjectSink 介面的分離提供者執行存取檢查。 如果安全性描述項為 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 命名空間 |