cniBufferByte

Ruft ein einzelnes Byte vom Datenpuffer ab, der mit Nachrichtenobjekt verknüpft ist (das auch der Eigner ist), das im Nachrichtenargument angegeben wurde. Der Wert des Indexarguments gibt an, welches Byte in der Bytefeldgruppe zurückgegeben werden soll.

Syntax

CciByte cniBufferByte(
  int*         returnCode,
  CciMessage*  message,
  CciSize      index);

Parameter

returnCode
Der Rückkehrcode von der Funktion (Ausgabe).
Mögliche Rückkehrcodes sind:
  • CCI_SUCCESS
  • CCI_EXCEPTION
  • CCI_INV_MESSAGE_OBJECT
message
Die Adresse des Nachrichtenobjekts, für das die Größe des Datenpuffers zurückgegeben werden soll (Eingabe).
index
Das Offset, das als Index im Puffer verwendet werden soll (Eingabe).

Rückgabewerte

Es wird das angeforderte Byte zurückgegeben. Beim Auftreten eines Fehlers gibt der Parameter returnCode den Grund dafür an.

Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as07630_