cniBufferByte

Diese Funktion ruft ein einzelnes Byte aus dem Datenpuffer ab, der dem Nachrichtenobjekt, das im Nachrichtenargument angegeben wurde, zugeordnet ist (und ihm gehört). 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 aus 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
Die relative Position, die als Index im Puffer verwendet werden soll (Eingabe).

Rückgabewerte

Das angeforderte Byte wird zurückgegeben. Wenn ein Fehler aufgetreten ist, gibt der Parameter returnCode die Fehlerursache an.

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