cniSqlNavigatePath

sqlPathExpression 인수에 정의된 대로 cniSqlCreateReadOnlyPathExpression 또는 cniSqlCreateModifiablePathExpression 유틸리티 함수를 사용하여 작성된 SQLPathExpression을 실행합니다.

구문

CciElement* cniSqlNavigatePath( 
	int*           returnCode,
	CciSqlPathExpression* sqlPathExpression,
	CciMessage*           inputMessageRoot,
	CciMessage*           inputLocalEnvironment,
	CciMessage*           inputExceptionList,       
	CciMessage*           outputMessageRoot
	CciMessage*           outputLocalEnvironment,
	CciMessage*           outputExceptionList);

매개변수

returnCode(출력)
널(null) 포인터 입력은 사용자 정의 노드가 오류를 처리하지 않음을 의미합니다. 이 호출 실행 중 전달된 모든 예외는 플로우의 다음 업스트림 노드에 다시 전달됩니다. 입력이 널(null)이 아닌 경우, 출력은 호출 성공 상태를 의미합니다. 실행 중 예외가 발생할 경우, *returnCode는 출력에 CCI_EXCEPTION으로 설정됩니다. cciGetLastExceptionData 호출은 예외에 대한 세부사항을 제공합니다. 올바르지 않은 sqlPathExpression 매개변수가 전달되면 returnCode가 CCI_INV_SQL_EXPR_OBJECT로 설정됩니다. 올바르지 않은 CciMessage* 값이 전달되면 returnCode가 CCI_INV_MESSAGE_OBJECT로 설정됩니다. 요소를 탐색하거나 작성할 수 없으면 returnCode가 CCI_PATH_NOT_NAVIGABLE로 설정됩니다.
sqlPathExpression(입력)
cniCreateReadOnlyPathExpression 또는 cniCreateModifyablePathExpression 함수가 리턴한 대로 실행할 SQLPathExpression 오브젝트를 지정합니다. 이 매개변수는 널(NULL)이 될 수 없습니다.
inputMessageRoot(입력)
입력 메시지를 나타내는 메시지. 이 매개변수는 널(NULL)이 될 수 없습니다.
inputLocalEnvironment(입력)
입력 로컬 환경을 나타내는 메시지. 이 매개변수는 널(NULL)이 될 수 없습니다.
inputExceptionList(입력)
입력 예외 목록을 나타내는 메시지. 이 매개변수는 널(NULL)이 될 수 없습니다.
outputMessageRoot(입력)
출력 메시지를 나타내는 메시지. 이 매개변수는 널(NULL)이 될 수 있습니다.
outputLocalEnvironment(입력)
출력 로컬 환경을 나타내는 메시지. 이 매개변수는 널(NULL)이 될 수 있습니다.
outputExceptionList(입력)
출력 예외 목록을 나타내는 메시지. 이 매개변수는 널(NULL)이 될 수 있습니다.

다음 표는 ESQL 경로 표현식에 승인되는 상관 이름과 액세스한 데이터 간의 맵핑을 보여줍니다.

상관 이름 액세스한 데이터
Environment 플로우에 대한 단일 환경 트리. 브로커가 판별하며 이 API를 통해 지정할 필요가 없습니다.
InputLocalEnvironment cniSqlNavigatePath의 inputLocalEnvironment 매개변수
OutputLocalEnvironment cniSqlNavigatePath의 outputLocalEnvironment 매개변수
InputRoot cniSqlNavigatePath의 inputMessageRoot 매개변수
InputBody InputRoot의 마지막 하위
InputProperties InputRoot.Properties
주: InputRoot.Properties는 "Properties"라는 InputRoot의 첫 번째 하위임
OutputRoot cniSqlNavigatePath의 outputMessageRoot 매개변수
InputExceptionList cniSqlNavigatePath의 inputExceptionList 매개변수
OutputExceptionList cniSqlNavigatePath의 outputExceptionList 매개변수
Database cniCreateReadOnlyPathExpression 또는 cniCreateModifyablePathExpression의 dataSourceName 매개변수가 식별하는 ODBC 데이터 소스
InputDestinationList InputLocalEnvironment와 동의어
OutputDestinationList OutputLocalEnvironment와 동의어

경로의 실제 탐색 가능성과 검증에 대한 다른 규칙은 모두 ESQL 필드 참조 문서를 따릅니다.

리턴 값

경로가 탐색되면 구문 요소의 주소가 리턴됩니다. . 그러나 경로를 탐색할 수 없으면 0 값(CCI_NULL_ADDR)이 리턴되고 returnCode 매개변수가 오류의 원인을 표시합니다.

SQLPathExpression( cniSqlCreateReadOnlyPathExpression 또는 cniSqlCreateModifiablePathExpression에 대한 예 참조)이 이미 작성된 것으로 가정하고 다음 코드를 사용하여 대상 요소를 탐색할 수 있습니다.

 CciElement* targetElement = cniSqlNavigatePath(
                           NULL,
                          ((NODE_CONTEXT_ST *)context)->pathExpression,
                           message,
                                                        destinationList,
                                                        exceptionList,
                           NULL, /*we do not reference any output trees*/
                           NULL,
                           NULL);
주의사항 | 등록상표 | 다운로드 | 라이브러리 | 지원 | 피드백
Copyright IBM Corporation 1999, 2006 마지막 갱신 날짜: 2006/08/21
as08033_