ICommandTree::FindErrorNodes 方法 (cmdtree.h)

注意

从 Windows XP 开始,索引服务不再受支持,并且自Windows 8起无法使用。 请改用 Windows 搜索 进行客户端搜索,使用 Microsoft Search Server Express 进行服务器端搜索。

ICommandTree::FindErrorNodes 方法遍历命令树并返回包含错误的节点数组。

语法

HRESULT FindErrorNodes(
  [in]  const DBCOMMANDTREE *pRoot,
  [out] ULONG               *pcErrorNodes,
  [out] DBCOMMANDTREE       ***prgErrorNodes
);

参数

[in] pRoot

指向命令树根的指针。

[out] pcErrorNodes

指向内存的指针,其中返回包含错误的节点数。

[out] prgErrorNodes

指向内存的指针,其中返回指向包含错误的节点的指针数组。 命令对象为此数组分配内存,并将地址返回到此内存;当使用者不再需要数组时,使用 IMalloc::Free 释放此内存。 如果输出时 *pcErrorNodes 为 0,则提供程序不会分配任何内存,因此可确保 *prgErrorNodes 在输出上为 null 指针。

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK
方法成功。
E_FAIL
发生了特定于访问接口的错误。
E_INVALIDARG
pRootspcErrorNodesprgErrorNodes 为 null 指针。
E_OUTOFMEMORY
提供程序无法分配足够的内存,以便返回指向包含错误的节点的指针数组。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 cmdtree.h

另请参阅

ICommandTree