cniGetThreadContext

Gibt den Thread-Kontext für den aktuellen Thread zurück.

Syntax

CciThreadContext *cniGetThreadContext(
  int                    *returnCode,
  CciMessageContext      *msgContext);

Parameters

returnCode
Hier handelt es sich um den Rückkehrcode der Funktion (Ausgabe). Wenn die Eingabe NULL ist, zeigt dies an, dass Fehler vom Broker stillschweigend bearbeitet oder ignoriert werden. Wenn die Eingabe nicht NULL ist, gibt die Ausgabe den Erfolgsstatus des Aufrufs an. Wenn der ParametermsgContext keinen gültigen Wert hat, wird *returnCode auf CCI_INV_MESSAGE_CONTEXT gesetzt und ein CciThreadContext NULL zurückgegeben.
msgContext
Über diesen Parameter wird der Nachrichtenkontext zur Verfügung gestellt, aus dem der thread-spezifische Kontext zu entnehmen ist. Es wird davon ausgegangen, dass dieser Parameter durch Verwendung der Dienstprogrammfunktion 'cniGetMessageContext' ermittelt wird.

Rückgabewerte

Wenn diese Funktion erfolgreich ist, gibt sie eine Handle auf die CciThreadContext-Instanz für den aktuellen Thread zurück.

Der cciMessageContext-Wert muss einer cciMessage-Instanz entsprechen, wobei die cciMessage-Instanz an die Funktion cniEvaluate bzw. die Funktion cniRun auf dem aktuellen Thread übergeben wird.

Beispiel

CciMessageContext* messageContext = cniGetMessageContext(NULL,message);
CciThreadContext*  threadContext  = cniGetThreadContext(NULL,messageContext);
Bemerkungen | Marken | Downloads | Bibliothek | Unterstützung | Rückmeldung
Copyright IBM Corporation 1999, 2006 Letzte Aktualisierung: 23. Aug. 2006
as24640_