MI_Application_InitializeV1, fonction (mi.h)

Initialise une application afin qu’elle puisse effectuer des appels d’API clientes d’infrastructure de gestion (MI).

Syntaxe

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

Paramètres

flags

Doit être égal à 0.

[in, optional] applicationID

Chaîne facultative (généralement GUID au format chaîne) pour représenter une application cliente. Cette chaîne peut être utilisée pour la configuration spécifique à l’application et la journalisation spécifique à l’application.

[out, optional] extendedError

Paramètre facultatif qui donne plus d’informations sur l’erreur en cas d’échec de l’opération. Si une instance est retournée, MI_Instance_Delete doit être appelée pour la libérer lorsqu’elle n’est plus nécessaire.

[out] application

Un pointeur vers un handle MI_Application non initialisé est passé et un handle rempli est retourné. Le handle initialisé doit être passé à MI_Application_Close avant l’arrêt de l’application. Si une application transmet ce handle, passez-le par valeur plutôt que par pointeur.

Valeur retournée

Cette fonction retourne MI_Result MI_MAIN_CALL.

Remarques

Cette API ne doit être appelée qu’une seule fois par application ; toutefois, il peut être appelé plusieurs fois en toute sécurité. L’appel de cette API plusieurs fois entraîne une petite utilisation de la mémoire supplémentaire. Lorsqu’elle est appelée, l’application passe un pointeur MI_Application à initialiser. Ce pointeur doit être fermé en appelant MI_Application_Close. Si vous ne le faites pas, vous risquez de provoquer des fuites de mémoire et des incidents potentiels pendant l’arrêt.

MI.h définit MI_Application_Initialize comme MI_Application_InitializeV1 avec cette ligne :

#define MI_Application_Initialize MI_Application_InitializeV1

Configuration requise