ICommandTree 인터페이스(cmdtree.h)

참고

인덱싱 서비스는 Windows XP를 기준으로 더 이상 지원되지 않으며 Windows 8 현재 사용할 수 없습니다. 대신 클라이언트 쪽 검색에 Windows Search 를 사용하고 서버 쪽 검색에 Microsoft Search Server Express 를 사용합니다.

ICommandTree 인터페이스는 명령을 지원하는 공급자에 대한 선택 사항입니다. 쿼리 트리를 조작하는 메서드가 포함되어 있습니다. 명령 트리를 지원하는 공급자는 ICommandText 인터페이스를 통해 동일한 기능을 지정하는 것도 지원해야 합니다.

명령 개체에는 하나의 명령만 있을 수 있습니다. 해당 명령은 명령 트리( ICommandTree에 지정됨) 또는 텍스트 명령( ICommandText에 지정됨)의 형식일 수 있습니다. 따라서 SetCommandTree 또는 ICommandText::SetCommandText 메서드를 통해 명령을 지정하면 명령이 텍스트 또는 트리 형식인지 여부에 관계없이 명령 개체의 명령을 대체합니다. GetCommandTree 또는 ICommandText::GetCommandText를 통해 명령을 검색하면 명령이 설정된 방식에 관계없이 지정된 형식으로 검색됩니다. 따라서 GetCommandText 메서드는 명령 트리를 명령 텍스트로 변환할 수 있어야 하며 GetCommandTree 메서드는 명령 텍스트를 명령 트리로 변환할 수 있어야 합니다. 후자의 변환에서 공급자는 텍스트의 탐색 가능한 명령 트리 표현을 반환해야 합니다. 이는 최적화된 형식일 필요는 없습니다. 공급자가 전체 표현을 만들 수 없는 경우 명령 트리는 단일 텍스트 노드로 구성될 수 있습니다.

대부분의 공급자는 명령 개체에서 만든 행 집합이 열려 있는 동안 ICommandTree 메서드가 새 명령 트리를 설정하는 것을 허용하지 않습니다. 행 집합은 원래 명령 트리의 결과 테이블을 직접 반영합니다. 그러나 일부 공급자는 행 집합이 열려 있는 경우에도 이 작업을 지원할 수 있습니다. 이 경우 새 명령 트리의 출력 스키마(열 집합)에는 현재 접근자가 있는 모든 열이 포함되어야 하며 모든 행 집합에 대한 접근자는 유효한 상태를 유지해야 합니다. 열려 있는 행 집합은 새 명령 트리의 결과 테이블을 반영하도록 동적으로 수정해야 합니다. 반환 행 핸들(hRows)은 유효한 상태로 유지됩니다. 즉, 새 정렬 순서 또는 새 선택 조건자가 해당 행에 적용되지 않으며 명령 트리 수정 후에 만든 모든 접근자는 명령 트리 수정 전에 얻은 hRows 와 함께 작동합니다. 명령 트리를 열린 행 집합으로 바꾸거나 수정하는 동안 오류가 발생하면 명령 개체, 명령 트리, 행 집합, hRows 및 접근자가 변경되지 않은 상태로 유지됩니다.

상속

ICommandTree 인터페이스는 IUnknown 인터페이스에서 상속됩니다. ICommandTree 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

ICommandTree 인터페이스에는 이러한 메서드가 있습니다.

ICommandTree::FindErrorNodes ICommandTree::FindErrorNodes 메서드는 명령 트리를 트래버스하고 오류가 있는 노드 배열을 반환합니다.
ICommandTree::FreeCommandTree ICommandTree::FreeCommandTree 메서드는 명령 트리를 트래버스하고 해당 구조체의 모든 변형뿐만 아니라 모든 DBCOMMANDTREE 노드 구조체의 할당을 취소합니다. 그런 다음, 루트 포인터를 NULL 포인터로 설정합니다.
ICommandTree::GetCommandTree ICommandTree::GetCommandTree 메서드는 추가된 모든 사후 처리 작업을 포함하여 현재 명령을 트리로 에코합니다.
ICommandTree::SetCommandTree ICommandTree::SetCommandTree 메서드는 명령 개체의 명령 트리를 설정하여 기존 명령 트리를 바꾸거나 지정된 텍스트 명령을 ICommandText 인터페이스로 대체합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	cmdtree.h