ICommandTree::FreeCommandTree 메서드(cmdtree.h)

참고

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

ICommandTree::FreeCommandTree 메서드는 명령 트리를 트래버스하고 모든 DBCOMMANDTREE 노드 구조와 해당 구조의 모든 변형을 할당 취소합니다. 그런 다음 루트 포인터를 NULL 포인터로 설정합니다.

구문

HRESULT FreeCommandTree(
  [in] DBCOMMANDTREE **ppRoot
);

매개 변수

[in] ppRoot

성공적으로 종료될 때 명령 트리의 루트에 대한 포인터를 수신하는 변수에 대한 포인터입니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.
E_FAIL	공급자 관련 오류가 발생했습니다.
E_INVALIDARG	ppRoot 매개 변수는 NULL 포인터였습니다.
DB_E_CANNOTFREE	소비자는 fCopy = FALSE를 사용하여 ICommandTree::SetCommandTree 메서드를 호출하여 공급자에게 메모리 소유권을 포기합니다.

설명

FreeCommandTree 메서드는 소비자가 로컬로 생성되거나 ICommandTree::GetCommandTree에서 가져온 명령 트리의 복사본을 해제하는 데 사용할 수 있습니다. 명령 개체가 소유한 트리의 복사본을 해제하지 않습니다. 소비자가 fCopy = FALSE를 사용하여 SetCommandTree를 호출하면 소비자는 메모리 소유권을 공급자에게 포기합니다. 따라서 소비자가 fCopy = FALSE를 사용하여 SetCommandTree를 호출한 후 FreeCommandTree를 호출하는 경우 FreeCommandTree는 DB_E_CANNOTFREE 오류 코드를 반환합니다. 즉, 소비자가 트리의 소유권이 없고 해제할 수 없습니다.

요구 사항

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

추가 정보

ICommandTree