función MI_Application_InitializeV1 (mi.h)

Inicializa una aplicación para que pueda realizar llamadas API de cliente de Infraestructura de administración (MI).

Sintaxis

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
);

Parámetros

flags

Debe ser 0.

[in, optional] applicationID

Cadena opcional (normalmente GUID en formato de cadena) para representar una aplicación cliente. Esta cadena se puede usar para la configuración específica de la aplicación y para el registro específico de la aplicación.

[out, optional] extendedError

Parámetro opcional que proporciona más información de error si se produjo un error en la operación. Si se devuelve una instancia, se debe llamar a MI_Instance_Delete para liberarla cuando ya no sea necesaria.

[out] application

Se pasa un puntero a un identificador de MI_Application sin inicializar y se devuelve un identificador rellenado. El identificador inicializado debe pasarse a MI_Application_Close antes de que se cierre la aplicación. Si una aplicación pasa este identificador, páselo por valor en lugar de como puntero.

Valor devuelto

Esta función devuelve MI_Result MI_MAIN_CALL.

Comentarios

Esta API debe llamarse solo una vez por aplicación; aunque, se puede llamar varias veces de forma segura. Llamar a esta API varias veces dará lugar a una pequeña cantidad de uso de memoria adicional. Cuando se llama a , la aplicación pasa un puntero de MI_Application que se va a inicializar. Este puntero debe cerrarse llamando a MI_Application_Close. Si no lo hace, se producirán pérdidas de memoria y posibles bloqueos durante el apagado.

MI.h define MI_Application_Initialize como MI_Application_InitializeV1 con esta línea:

#define MI_Application_Initialize MI_Application_InitializeV1

Requisitos