функция MI_Application_NewHostedProvider (mi.h)

Регистрирует размещенного поставщика в подсистеме WMI на локальном компьютере.

Синтаксис

MI_INLINE MI_Result MI_Application_NewHostedProvider(
  [in]            MI_Application    *application,
  [in]            const MI_Char     *namespaceName,
  [in]            const MI_Char     *providerName,
  [in]            MI_MainFunction   mi_Main,
  [out, optional] MI_Instance       **extendedError,
  [out]           MI_HostedProvider *hostedProvider
);

Параметры

[in] application

Указатель на дескриптор, возвращенный функцией MI_Application_Initialize .

[in] namespaceName

Указатель на пространство имен, в котором зарегистрирован поставщик. Например, L"root/cimv2".

[in] providerName

Указатель на имя поставщика, зарегистрированного в подсистеме WMI для этого размещенного поставщика.

[in] mi_Main

Основная точка входа к поставщику mi mi.

[out, optional] extendedError

Указатель на указатель на необязательный параметр для получения расширенных сведений об ошибке в случае сбоя API. Если передается указатель, может быть возвращен экземпляр ошибки. Если возвращается экземпляр ошибки, после завершения использования удалите его с помощью функции MI_Instance_Delete .

[out] hostedProvider

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

Возвращаемое значение

Эта функция возвращает MI_INLINE MI_Result.

Комментарии

Размещенный поставщик — это поставщик, который находится в клиентском приложении, а не в хост-процессе службы WMI. Клиент управляет временем существования этих поставщиков. Размещенные поставщики регистрируются иначе, чем обычные поставщики. Эта другая регистрация указывает, что служба WMI будет размещена клиентом. Завершив работу с поставщиком, приложение должно завершить работу, вызвав функцию MI_HostedProvider_Close .

Требования

Требование Значение
Минимальная версия клиента Windows 8
Минимальная версия сервера Windows Server 2012
Целевая платформа Windows
Header mi.h
Распространяемые компоненты Windows Management Framework 3.0 в Windows Server 2008 R2 с пакетом обновления 1 (SP1), Windows 7 с пакетом обновления 1 (SP1) и Windows Server 2008 с пакетом обновления 2 (SP2)