класс __Win32Provider

  • Статья

Системный класс __Win32Provider регистрирует сведения о физической реализации поставщика в WMI. Поставщики, которые не задают свойство HostingModel , по умолчанию загружаются для выполнения в Wmiprvse.exe процессе как NetworkServiceHostOrSelfHost.

Приведенный ниже синтаксис является упрощенной версией кода 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 имеет следующие типы членов:

Элемент Property

Класс __Win32Provider имеет эти свойства.

ClientLoadableCLSID

Тип данных: string

Тип доступа: чтение и запись

Идентификатор класса, который WMI использует для определения того, следует ли загружать высокопроизводительный поставщик в клиентский или WMI-процесс. Если поставщик и клиент находятся на одном компьютере, инструментарий WMI загружает поставщик внутри процесса клиенту, используя ClientLoadableCLSID в качестве идентификатора класса. Если поставщик и клиент находятся на разных компьютерах, WMI загружает внутрипроцессный поставщик в WMI. WMI также использует ClientLoadableCLSID для поддержки операций обновления.

Дополнительные сведения см. в разделе Регистрация поставщика High-Performance.

CLSID

Тип данных: string

Тип доступа: чтение и запись

GUID , представляющий идентификатор класса (CLSID) COM-объекта поставщика. Этот COM-объект должен содержать реализацию интерфейса IWbemProviderInit .

Параллелизм

Тип данных: sint32

Тип доступа: чтение и запись

Не используется.

DefaultMachineName

Тип данных: string

Тип доступа: чтение и запись

Определяет компьютер, на котором запускается поставщик. Если поставщик выполняется на локальном компьютере, он имеет значение NULL.

Enabled

Тип данных: boolean

Тип доступа: чтение и запись

Если задано значение TRUE, этот экземпляр включен и может использоваться для выполнения клиентских запросов.

HostingModel

Тип данных: string

Тип доступа: чтение и запись

Это свойство состоит из значений свойств MSFT_ProvidersHostingGroup и HostingSpecification . Значение этого свойства указывает, как WMI загружает поставщик и учетную запись безопасности, под которой он выполняется. Дополнительные сведения о настройке свойства HostingModel см. в разделах Размещение и безопасность поставщика и Регистрация поставщика.

ImpersonationLevel

Тип данных: sint32

Тип доступа: чтение и запись

Зарезервировано. Значение по умолчанию равно нулю (0).

ИнициализацияReentrancy

Тип данных: sint32

Тип доступа: чтение и запись

Набор флагов, предоставляющих сведения о сериализации. Значение по умолчанию равно нулю (0).

0

Вся инициализация этого поставщика должна быть сериализована.

1

Все инициализации этого поставщика в одном пространстве имен должны быть сериализованы.

2

Сериализация инициализации не требуется.

InitializationTimeoutInterval

Тип данных: datetime

Тип доступа: чтение и запись

Не используется.

InitializeAsAdminFirst

Тип данных: boolean

Тип доступа: чтение и запись

TBD

имя;

Тип данных: string

Тип доступа: чтение и запись

Квалификаторы: Ключ

Имя поставщика.

OperationTimeoutInterval

Тип данных: datetime

Тип доступа: чтение и запись

Не используется.

PerLocaleInitialization

Тип данных: boolean

Тип доступа: чтение и запись

Если задано значение TRUE, поставщик инициализируется для каждого языкового стандарта, когда пользователь подключается к одному пространству имен несколько раз с использованием разных языковых стандартов. Значение по умолчанию — FALSE.

PerUserInitialization

Тип данных: boolean

Тип доступа: чтение и запись

Если задано значение TRUE, поставщик инициализируется один раз для каждого пользователя NT LAN Manager (NTLM), который отправляет запросы к поставщику. Если значение FALSE (по умолчанию), поставщик инициализируется один раз для всех пользователей.

Чистый

Тип данных: boolean

Тип доступа: чтение и запись

Если задано значение TRUE, поставщик соглашается подготовиться к выгрузке путем вызова IUnknown::Release для всех невыполненных точек интерфейса, когда WMI вызывает метод Release своего основного интерфейса. Поставщики, которые должны оставаться клиентами WMI после того, как они не работают в качестве поставщиков, должны задать для Pure значение FALSE. Значение по умолчанию — TRUE. Дополнительные сведения см. в разделе Примечания этой статьи.

SecurityDescriptor

Тип данных: string

Тип доступа: чтение и запись

Дескриптор безопасности (SD) на языке определения дескриптора безопасности (SDDL), определяющий набор пользователей, которые могут успешно вызывать IWbemDecoupledRegistrar:Register для несвязанного поставщика. Дополнительные сведения см. в разделе Язык определения дескриптора безопасности в разделе Безопасность пакета Windows SDK. Этот дескриптор безопасности используется только для несвязанных поставщиков и не влияет на других поставщиков. Дополнительные сведения см. в разделе Включение поставщика в приложение.

WMI проверяет доступ для разроженных поставщиков, использующих интерфейсы IWbemProviderInit и IWbemObjectSink . Если дескриптор безопасности имеет значение NULL, то только приложения или службы, которые выполняются в учетных записях LocalSystem, NetworkService и LocalService, могут запускать несвязанный поставщик.

В следующей строке показан несвязанный поставщик, который будет выполняться только встроенными администраторами". O:BAG:BAD:(A;;0 x1;;; BA)"

Дополнительные сведения о настройке свойства SecurityDescriptor см. в разделе Обслуживание безопасности WMI.

SupportsExplicitShutdown

Тип данных: boolean

Тип доступа: чтение и запись

Не используется.

SupportsExtendedStatus

Тип данных: boolean

Тип доступа: чтение и запись

Не используется.

SupportsQuotas

Тип данных: boolean

Тип доступа: чтение и запись

Не используется.

SupportsSendStatus

Тип данных: boolean

Тип доступа: чтение и запись

Не используется.

SupportsShutdown

Тип данных: boolean

Тип доступа: чтение и запись

Не используется.

SupportsThrottling

Тип данных: boolean

Тип доступа: чтение и запись

Не используется.

UnloadTimeout

Тип данных: datetime

Тип доступа: чтение и запись

Формат даты и времени , указывающий, как долго WMI позволяет поставщику оставаться в состоянии простоя до его выгрузки. Как правило, поставщики запрашивают, чтобы WMI ждал не более пяти минут.

Для текущей версии WMI значение этого свойства игнорируется. WMI выгружает поставщик на основе значения времени ожидания во внутреннем классе в пространстве имен \root. Рекомендуется, чтобы поставщики устанавливали UnloadTimeout. Дополнительные сведения см. в разделе Выгрузка поставщика.

Версия

Тип данных: uint32

Тип доступа: чтение и запись

Версия поставщика. Поддерживаемые версии: 1 и 2. Версия 2 усиливает проверки допустимости для всех связанных регистраций свойств, в частности для свойства ImpersonationLevel .

Комментарии

Класс __Win32Provider является производным от __Provider.

Большинство поставщиков могут принимать значения по умолчанию для свойства InitializationReentrancy . Однако если поставщик может поддерживать одновременную инициализацию для отдельных пользователей, этому свойству можно присвоить значение 1 (один). Если требуется сериализованная инициализация, значение InitializationReentrancy остается равным 0 (нулю). В обоих экземплярах PerUserInitialization имеет значение TRUE.

Чистый поставщик или поставщик, задающий для свойства Pure значение TRUE, существует только для запросов на обслуживание от приложений и инструментария WMI. Большинство поставщиков являются чистыми поставщиками. Исключением является поставщик некюры. Поставщики, не являющиеся клиентами, переходят на роль клиента после выполнения запросов на обслуживание.

Примером неплатежного поставщика является поставщик push-уведомлений, который начинает выдавать запросы и выполняет запросы инструментария WMI после завершения инициализации. Поставщик принудительной отправки не несет ответственности, за исключением обновления репозитория CIM данными во время инициализации. После обновления репозитория поставщик push-уведомлений может дождаться выгрузки или перейти на роль клиента. Поставщик push-уведомлений, ожидающий выгрузки, является чистым поставщиком. Поставщик push-уведомлений, участвующий в действиях клиента, не является кошельком.

Инструментарий WMI должен иметь возможность отличать чистых поставщиков от нечистых, чтобы определить, когда безопасно завершить работу. Инструментарий WMI должен дождаться завершения всех операций, в которых участвуют не чистые поставщики, прежде чем безопасно завершить работу.

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista
Минимальная версия сервера
 Windows Server 2008
Пространство имен
 Все пространства имен WMI

См. также раздел

__Поставщика

Системные классы WMI

Регистрация поставщика