CPI-C-Aufrufe
In diesem Abschnitt werden die CPI-C-Aufrufe (Common Programming Interface for Communications) beschrieben. Die folgenden Informationen werden für jeden Aufruf bereitgestellt:
Das Pseudonym für den Aufruf und den tatsächlichen C-Funktionsnamen.
Eine Definition des Aufrufs.
Eine Liste der vom Aufruf verwendeten Parameter und des Datentyps für jeden Parameter. Der Prototyp jeder Funktion wird in WINCPIC deklariert. H-Datei.
Eine Beschreibung der einzelnen Eingabe- und Ausgabeparameter. Die Parameternamen sind Pseudonyme, und die tatsächlichen Namen für diese Parameter werden vom Anwendungsprogramm deklariert. Die Beschreibung enthält die möglichen Werte des Parameters.
Die Konversationszustände, in denen der Anruf ausgegeben werden kann.
Die Zustände, in die sich die Unterhaltung ändern kann, wenn sie vom Anruf zurückgegeben wird. Bedingungen, die keine Zustandsänderung verursachen, werden nicht notiert. Parameter- und Zustandsüberprüfungen führen beispielsweise nicht zu einer Zustandsänderung.
Zusätzliche Informationen zur Verwendung des Aufrufs.
Datentypen
Die Datentypen für die parameter, die für CPI-C bereitgestellt und von CPI-C empfangen werden, werden von #define-Anweisungen in der WINCPIC als symbolische Konstanten festgelegt. H-Datei. Beispielsweise stellt CM_INT32 signierte long int und CM_PTR far \* dar. Die Verwendung symbolischer Konstanten verbessert die Portabilität von CPI-C-Anwendungen.
Zur Vereinfachung des Verständnisses werden in dieser Referenz die Datentypen in absoluten (nicht #defined) Ausdrücken dargestellt.
Beim Schreiben von Anwendungen sollten Sie die symbolischen Konstanten aus der WINCPIC verwenden. H-Datei.
Symbolische Konstanten
Die meisten Parameter, die für CPI-C bereitgestellt und von CPI-C zurückgegeben werden, sind 32-Bit-Ganzzahlen. Um die Codierung zu vereinfachen, werden die Werte für diese Parameter durch aussagekräftige symbolische Konstanten dargestellt, die durch #define-Anweisungen im WINCPIC festgelegt werden. H-Headerdatei. Der Wert CM_MAPPED_CONVERSATION stellt beispielsweise die ganze Zahl 1 dar. Um die Lesbarkeit zu verbessern, verwenden Sie beim Schreiben von Programmen nur die symbolischen Konstanten.
Zeichenfolgen
Alle Zeichenfolgen sind im ASCII-Format, wenn sie über die CPI-C-Schnittstelle übergeben werden.
Gültigkeit von Ausgabeparametern
Die von CPI-C zurückgegebenen Parameter sind nur gültig, wenn der CPI-C-Aufruf erfolgreich ausgeführt wird, wie durch einen Rückgabecode von CM_OK angegeben.