Condividi tramite


GetFmiReturnCode

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 da usare dalle 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 con terminazione Null formattata.

Valori restituiti

0x20000001
I parametri non sono validi; La funzione non è stata in grado di leggere i codici di errore specificati o di non scrivere nel buffer specificato.

0x20000002
Il buffer specificato è troppo piccolo.

Osservazioni:

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 perLa risposta Open(SSCP), Open(PLU) Confirm, Status-Acknowledgement(Nack-2), Status-Control(...) Messaggi Nack2, Status-Error e Appl-Data con l'indicatore di errore rilevato dal sistema (SDI) impostato Non modificato dal messaggio Non modificato dal messaggio
Codici di stato e qualificatore restituiti da un messaggio status-session status*256 + qualificatore 0xFFFF
Codice restituito da WinLUAGetLastInitStatus Codice restituito 0xFFFF