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 Anmerkung: 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 für cniCreateReadOnlyPathExpression oder cniCreateModifyablePathExpression |
InputDestinationList | Synonym für InputLocalEnvironment |
OutputDestinationList | Synonym für OutputLocalEnvironment |
Alle anderen Regeln zur tatsächlichen Navigierbarkeit und Gültigkeit von Pfaden sind in der Dokumentation zur ESQL-Feldreferenz angegeben.
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, destinationList, exceptionList, NULL, /*auf Ausgabebaumstrukturen wird nicht verwiesen*/ NULL, NULL);