Format d'appel EHLLAPI

Le point d'entrée EHLLAPI (hllapi) est toujours appelé avec les quatre paramètres suivants :

1. Numéro de fonction EHLLAPI (entrée)
2. Tampon de données (entrée/sortie)
3. Longueur du tampon (entrée/sortie)
4. Position (entrée) ; Code retour (sortie)

Le prototype pour IBM® Standard EHLLAPI est :

[long hllapi (LPWORD, LPSTR, LPWORD, LPWORD);

Le prototype pour IBM® Enhanced EHLLAPI est :

[long hllapi (LPINT, LPSTR, LPINT, LPINT);

Chaque paramètre est transmis par référence et non par valeur. Ainsi, chaque paramètre de l'appel de fonction doit être un pointeur vers la valeur, pas la valeur elle-même. Par exemple, ce qui suit est un exemple correct d’appel de la fonction EHLLAPI Query Session Status :

 #include "hapi_c.h" struct HLDQuerySessionStatus QueryData; int Func, Len, Rc; long Rc; memset(QueryData, 0, sizeof(QueryData)); // Init buffer QueryData.qsst_shortname = 'A'; // Session to query Func = HA_QUERY_SESSION_STATUS; // Function number Len = sizeof(QueryData); // Len of buffer Rc = 0; // Unused on input hllapi(&Func, (char *)&QueryData, &Len, &Rc); // Call EHLLAPI if (Rc != 0) { // Check return code // ...Error handling }

Tous les paramètres de l'appel hllapi sont des pointeurs et le code retour de la fonction EHLLAPI est renvoyé dans la valeur du 4ème paramètre, et non comme la valeur de la fonction. Par exemple, ce qui suit n'est pas correct :

 if (hllapi(&Func, (char *)&QueryData, &Len, &Rc) != 0) { // WRONG! // ...Error handling }