Chiamate CPI-C
Questa sezione descrive le chiamate COMMON Programming Interface for Communications (CPI-C). Per ogni chiamata vengono fornite le informazioni seguenti:
Pseudonimo per la chiamata e il nome effettivo della funzione C.
Definizione della chiamata.
Elenco dei parametri utilizzati 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 #define istruzioni in WINCPIC. File H. Ad esempio, CM_INT32 rappresenta l'oggetto signed long int e CM_PTR rappresenta la distanza \*. 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 e restituiti da CPI-C è un numero intero 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.