__Win32Provider 類別

發行項
06/13/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 來支援重新整理作業。

如需詳細資訊，請參閱註冊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 命名空間

另請參閱

__供應商
WMI 系統類別
註冊提供者

共用方式為

__Win32Provider 類別

語法

成員

屬性

備註

規格需求

另請參閱

意見反應

其他資源