Condividi tramite

chiamate CPI-C

In questa sezione vengono descritte le chiamate Common Programming Interface for Communications (CPI-C). Per ogni chiamata vengono fornite le informazioni seguenti:

  • Pseudonimo della chiamata e del nome effettivo della funzione C.

  • Definizione della chiamata.

  • Elenco dei parametri usati dalla chiamata e dal tipo di dati per ogni parametro. Il prototipo di ogni funzione viene dichiarato in WINCPIC. File H.

  • Descrizione di ogni parametro di input e output. I nomi dei parametri sono pseudonimi e i nomi effettivi per questi parametri vengono dichiarati dal programma dell'applicazione. La descrizione include i valori possibili del parametro .

  • Stati della conversazione in cui è possibile eseguire la chiamata.

  • Stati a cui la conversazione può cambiare al ritorno dalla chiamata. Le condizioni che non causano una modifica dello stato non vengono annotate. Ad esempio, i controlli dei parametri e i controlli di stato non causano una modifica dello stato.

  • Informazioni aggiuntive che descrivono l'uso della chiamata.

    Tipi di dati

    I tipi di dati per i parametri forniti e ricevuti da CPI-C vengono stabiliti come costanti simboliche da istruzioni #define in WINCPIC. File H. Ad esempio, CM_INT32 rappresenta il valore di long int con segno e CM_PTR rappresenta lontano \*. L'uso di costanti simboliche migliora la portabilità delle applicazioni CPI-C.

    Per semplificare la comprensione, questo riferimento presenta i tipi di dati in termini assoluti (non #defined).

    Nella scrittura di applicazioni, è consigliabile usare le costanti simboliche di WINCPIC. File H.

    Costanti simboliche

    La maggior parte dei parametri forniti a e restituiti da CPI-C sono numeri interi a 32 bit. Per semplificare la codifica, i valori per questi parametri sono rappresentati da costanti simboliche significative, stabilite dalle istruzioni #define in WINCPIC. File di intestazione H. Ad esempio, il valore CM_MAPPED_CONVERSATION rappresenta l'intero 1. Per motivi di leggibilità, utilizzare solo le costanti simboliche durante la scrittura di programmi.

    Stringhe

    Tutte le stringhe sono in formato ASCII quando vengono passate attraverso l'interfaccia CPI-C.

    Validità dei parametri di output

    I parametri restituiti da CPI-C sono validi solo se la chiamata CPI-C viene eseguita correttamente, come indicato da un codice restituito di CM_OK.

In questa sezione

  • Last updated on