Structures de données
De nombreuses fonctions EHLLAPI utilisent une structure de données formatée pour transmettre des informations vers ou depuis le programme d'application. La description de chaque fonction montre la disposition de la structure des données. Les données transmises vers ou depuis la fonction EHLLAPI doivent exister dans le stockage exactement comme indiqué, octet par octet. Notez que la présentation de la structure est la même pour toutes les applications IBM® Standard et WinHLLAPI 16 et 32 bits. Les structures de données pour les applications IBM® Enhanced 32 bits sont regroupées selon un alignement sur 4 octets.
Il est fortement recommandé d'utiliser les définitions de fichier d'en-tête et de structure de données fournies pour garantir un alignement et une présentation appropriés des données. Bien que cela soit techniquement possible, ce qui suit n'est pas recommandé :
char QueryData[20]; // Not recommended ... Func = HA_QUERY_SESSION_STATUS; hllapi(&Func, QueryData, &Len, &Rc); if (QueryData[13] == 'F') { // ...this is a 5250 session }La manière recommandée pour écrire cette fonction serait :
#include "hapi_c.h" struct HLDQuerySessionStatus QueryData; // Recommended ... Func = HA_QUERY_SESSION_STATUS; hllapi(&Func, (char *)&QueryData, &Len, &Rc); if (QueryData.qsst_sestype == 'F') { // ...this is a 5250 session }