Partager via

GetFmiReturnCode

  • Article

La fonction GetFmiReturnCode convertit les status de 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 vers 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
Le tampon spécifié est trop petit.

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 pour errcode2
Les valeurs errcode1 et errcode2 spécifiées dans Codes d’erreur et de détection incluent les messagesopen(SSCP) Response, Open(PLU) Confirm, Status-Acknowledge(Nack-2), Status-Control(...) Messages Nack2, Status-Error et Appl-Data avec l’indicateur d’erreur détecté (SDI) défini par le système Inchangé par rapport au message Inchangé par rapport au message
Codes de status et de qualificateur retournés à partir d’un message Status-Session status*256 + qualificateur 0xFFFF
Code de retour de WinLUAGetLastInitStatus Code de retour 0xFFFF