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

Инициализирует приложение для выполнения вызовов API клиента инфраструктуры управления (MI).

Синтаксис

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

Требования