__Win32Provider 類別

發行項
05/11/2022

__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

資料類型：字串
存取類型：讀取/寫入

此屬性是由來自 MSFT_ProvidersHostingGroup和HostingSpecification屬性的值所組成。此屬性的值會指定 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來準備卸載。在 WMI 的用戶端無法運作之後，必須保留 WMI 的提供者，應該將 Pure 設定為 FALSE。預設設定為 TRUE。如需詳細資訊，請參閱本主題的一節。

SecurityDescriptor

資料類型：字串
存取類型：讀取/寫入

安全性描述元 (SD) 安全性描述元定義語言 (SDDL) ，決定可成功呼叫 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

資料類型： 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 命名空間

另請參閱

__Provider
WMI 系統類別
註冊提供者