GetFmiReturnCode

La fonction GetFmiReturnCode convertit l’état du lien et les codes d’erreur en chaîne imprimable. Cette fonction fournit un ensemble standard de chaînes d’erreur à utiliser par les applications FMI (Function Management Interface).

Syntaxe

  
int WINAPI GetFmiReturnCode (  
    UINT errcode1,  
    UINT errcode2,  
    UINT buffer_length,  
    unsigned char FAR *buffer_addr  
);  

Paramètres

errcode1
Paramètre fourni ; voir Remarques.

errcode2
Paramètre fourni ; voir Remarques.

buffer_length
Paramètre fourni ; spécifie la longueur de la mémoire tampon pointée par buffer_addr. La longueur recommandée est de 256 caractères.

buffer_addr
Paramètre fourni/retourné ; spécifie l’adresse de la mémoire tampon qui contiendra la chaîne mise en forme et terminée par null.

Valeurs de retour

0x20000001
Les paramètres ne sont pas valides ; la fonction n’a pas pu lire les codes d’erreur spécifiés ou n’a pas pu écrire dans la mémoire tampon spécifiée.

0x20000002
La mémoire tampon spécifiée est trop petite.

Remarques

Les paramètres errcode1 et errcode2 sont définis en fonction de la façon dont GetFmiReturnCode est utilisé, comme indiqué dans le tableau suivant.

Codes à traduire	Valeur de errcode1	Valeur de errcode2
Les valeurs errcode1 et errcode2 spécifiées dans Codes d’erreur et de sens incluent des messages pour laréponse Open(SSCP),Open(PLU) Confirm, Status-Acknowledge(Nack-2), Status-Control(...) Messages Nack2, Status-Error et Appl-Data avec l’indicateur d’erreur (SDI) détecté par le système	Inchangé par rapport au message	Inchangé par rapport au message
Codes d’état et de qualificateur retournés par un message Status-Session	status*256 + qualificateur	0xFFFF
Code de retour de WinLUAGetLastInitStatus	Code de retour	0xFFFF