通过

MI_Application_InitializeV1 函数 (mi.h)

  • 项目

初始化应用程序，使管理基础结构 (MI) 客户端 API 调用。

语法

MI_Result MI_MAIN_CALL MI_Application_InitializeV1(
                  MI_Uint32      flags,
  [in, optional]  const MI_Char  *applicationID,
  [out, optional] MI_Instance    **extendedError,
  [out]           MI_Application *application
);

参数

flags

必须为 0。

[in, optional] applicationID

可选的字符串通常 (字符串格式的 GUID) 表示客户端应用程序。 此字符串可用于特定于应用程序的配置和特定于应用程序的日志记录。

[out, optional] extendedError

可选参数，在操作失败时提供更多错误信息。 如果返回实例，则必须调用 MI_Instance_Delete 以在不再需要实例时将其释放。

[out] application

传入指向未初始化 MI_Application 句柄的指针，并返回填充的句柄。 在应用程序关闭之前，必须将初始化的句柄传递给 MI_Application_Close 。 如果应用程序传递此句柄，则按值而不是作为指针传递它。

返回值

此函数返回MI_Result MI_MAIN_CALL。

注解

每个应用程序只需调用此 API 一次;不过，它可以安全地调用多次。 多次调用此 API 将导致少量的额外内存使用量。 调用时，应用程序会传入要初始化 的MI_Application 指针。 必须通过调用 MI_Application_Close 关闭此指针。 否则会导致关闭期间内存泄漏和潜在崩溃。

MI.h 通过以下行将 MI_Application_Initialize 定义为 MI_Application_InitializeV1 ：

#define MI_Application_Initialize MI_Application_InitializeV1

要求

要求 值
最低受支持的客户端 Windows 8
最低受支持的服务器 Windows Server 2012
目标平台 Windows
标头 mi.h
Library Mi.lib
DLL Mi.dll
可再发行组件 windows Server 2008 R2 SP1、Windows 7 SP1 和 Windows Server 2008 SP2 上的 Windows Management Framework 3.0