Condividi tramite

GetFmiReturnCode

  • Articolo

La funzione GetFmiReturnCode converte lo stato del collegamento e i codici di errore in una stringa stampabile. Questa funzione fornisce un set standard di stringhe di errore per l'uso da parte delle applicazioni FMI (Function Management Interface).

Sintassi

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

Parametri

errcode1
Parametro fornito; vedere Osservazioni.

errcode2
Parametro fornito; vedere Osservazioni.

buffer_length
Parametro fornito; specifica la lunghezza del buffer a cui punta buffer_addr. La lunghezza consigliata è di 256 caratteri.

buffer_addr
Parametro fornito/restituito; specifica l'indirizzo del buffer che conterrà la stringa formattata e con terminazione null.

Valori restituiti

0x20000001
I parametri non sono validi; la funzione non è riuscita a leggere i codici di errore specificati o non è stato possibile scrivere nel buffer specificato.

0x20000002
Il buffer specificato è troppo piccolo.

Commenti

I parametri errcode1 e errcode2 vengono impostati in base al modo in cui viene usato GetFmiReturnCode , come illustrato nella tabella seguente.

Codici da tradurre Valore per errcode1 Valore per errcode2
I valori errcode1 e errcode2 specificati in Error and Sense Codes includono messaggi per Larisposta Open(SSCP), Open(PLU) Confirm, Status-Confirm(Nack-2), Status-Control(...) Messaggi Nack2, Status-Error e Appl-Data con il set di indicatori di errore rilevati dal sistema Invariato dal messaggio Invariato dal messaggio
Codici di stato e qualificatori restituiti da un messaggio Status-Session status*256 + qualificatore 0xFFFF
Codice restituito da WinLUAGetLastInitStatus Codice restituito 0xFFFF