Führt den Ausdruck 'SQLPathExpression' aus, der zuvor mit den Dienstprogrammfunktionen cniSqlCreateReadOnlyPathExpression oder cniSqlCreateModifiablePathExpression erstellt wurde, wie er im Argument 'sqlPathExpression' definiert wurde.
CciElement* cniSqlNavigatePath( int* returnCode, CciSqlPathExpression* sqlPathExpression, CciMessage* inputMessageRoot, CciMessage* inputLocalEnvironment, CciMessage* inputExceptionList, CciMessage* outputMessageRoot CciMessage* outputLocalEnvironment, CciMessage* outputExceptionList);
In der folgenden Tabelle wird die Zuordnung zwischen den im ESQL-Pfadausdruck akzeptierten Korrelationsnamen und den Daten, auf die zugegriffen wird, dargestellt.
Korrelationsname | Daten, auf die zugegriffen wird |
---|---|
Umgebung | Die einzelne Baumstruktur der Umgebung für den Datenfluss. Diese wird vom Broker festgelegt. Es ist nicht nötig, diese über diese API anzugeben. |
InputLocalEnvironment | InputLocalEnvironment-Parameter für cniSqlNavigatePath |
OutputLocalEnvironment | outputLocalEnvironment-Parameter für cniSqlNavigatePath |
InputRoot | inputMessageRoot-Parameter für cniSqlNavigatePath |
InputBody | Untergeordnetes Element von InputRoot |
InputProperties | InputRoot.Properties (InputRoot.Properties ist das untergeordnete Element von InputRoot, genannt "Properties") |
OutputRoot | outputMessageRoot-Parameter für cniSqlNavigatePath |
InputExceptionList | inputExceptionList-Parameter für cniSqlNavigatePath |
OutputExceptionList | outputExceptionList-Parameter für cniSqlNavigatePath |
Datenbankausnahmen | ODBC-Datenquelle, angegeben durch den 'dataSourceName'-Parameter fr cniCreateReadOnlyPathExpression oder cniCreateModifyablePathExpression |
InputDestinationList | Synonym für InputLocalEnvironment, das mit älteren Versionen kompatibel ist |
OutputDestinationList | Synonym für OutputLocalEnvironment, das mit älteren Versionen kompatibel ist |
Alle anderen Regeln zur tatsächlichen Navigierbarkeit und Gültigkeit von Pfaden sind unter Korrelationsnamen definiert.
Angenommen, es wurde zuvor ein SQLPathExpression erstellt (siehe im Beispiel für cniSqlCreateReadOnlyPathExpression oder cniSqlCreateModifiablePathExpression), dann könnte mit dem folgenden Code zum Zielelement navigiert werden.
CciElement* targetElement = cniSqlNavigatePath( NULL, ((NODE_CONTEXT_ST *)context)->pathExpression, message, localEnvironment, exceptionList, NULL, /*auf Ausgabebaumstrukturen wird nicht verwiesen*/ NULL, NULL);