GetFmiReturnCode

Die GetFmiReturnCode-Funktion konvertiert Link-status und Fehlercodes in eine druckbare Zeichenfolge. Diese Funktion stellt einen Standardsatz von Fehlerzeichenfolgen bereit, die von FMI-Anwendungen (Function Management Interface) verwendet werden können.

Syntax

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

Parameter

errcode1
Angegebener Parameter; siehe Hinweise.

errcode2
Angegebener Parameter; siehe Hinweise.

buffer_length
Angegebener Parameter; gibt die Länge des Puffers an, auf den buffer_addr. Die empfohlene Länge beträgt 256 Zeichen.

buffer_addr
Angegebener/zurückgegebener Parameter; gibt die Adresse des Puffers an, der die formatierte, NULL-endende Zeichenfolge enthält.

Rückgabewerte

0x20000001
Die Parameter sind ungültig. Die Funktion konnte die angegebenen Fehlercodes nicht lesen oder nicht in den angegebenen Puffer schreiben.

0x20000002
Der angegebene Puffer ist zu klein.

Hinweise

Die Parameter errcode1 und errcode2 werden entsprechend der Verwendung von GetFmiReturnCode festgelegt, wie in der folgenden Tabelle gezeigt.

Zu übersetzende Codes	Wert für errcode1	Wert für errcode2
Die in Error and Sense Codes angegebenen Werte errcode1 und errcode2 enthalten Meldungen fürOpen(SSCP) Response, Open(PLU) Confirm, Status-Acknowledge(Nack-2), Status-Control(...) Nack2-, Status-Error- und Appl-Data-Meldungen mit festgelegtem System Detected Error Indicator (SDI)	Unverändert von der Nachricht	Unverändert von der Nachricht
Die status- und Qualifizierercodes, die von einer Status-Session-Nachricht zurückgegeben werden	status*256 + Qualifizierer	0xFFFF
Der Rückgabecode von WinLUAGetLastInitStatus	Der Rückgabecode	0xFFFF