JetGetInstanceInfo 函数

  • 项目

适用于： Windows |Windows Server

JetGetInstanceInfo 函数

JetGetInstanceInfo 函数检索有关正在运行的实例的信息。

Windows XP：JetGetInstanceInfo 在 Windows XP 中引入。

    JET_ERR JET_API JetGetInstanceInfo(
      __out         unsigned long* pcInstanceInfo,
      __out         JET_INSTANCE_INFO** paInstanceInfo
    );

parameters

pcInstanceInfo

指向缓冲区的指针，该缓冲区将接收 存储在 paInstanceInfo 中的元素数。

paInstanceInfo

指向缓冲区的指针，该缓冲区将接收结构数组中第一个元素的地址。

返回值

此函数返回具有以下返回代码之一 的JET_ERR 数据类型。 有关可能的 ESE 错误的详细信息，请参阅 可扩展存储引擎错误 和 错误处理参数。

返回代码

说明

JET_errSuccess

操作已成功完成。

JET_errInvalidParameter

提供的其中一个参数包含意外值或包含一个值，当与另一个参数的值组合时，该值没有意义。 在以下情况下 ，JetGetInstanceInfo 将返回此错误：

  • pcInstanceInfo 或 paInstanceInfo 为 NULL。

JET_errOutOfMemory

内存不足，无法处理请求。

备注

数据库引擎将分配 JET_INSTANCE_INFO结构的数组 。 调用方负责使用 JetFreeBuffer 释放此内存。

如果没有活动实例， JetGetInstanceInfo 将返回JET_errSuccess， pcInstanceInfo 将收到值 0。

要求

要求 值

客户端

需要 Windows Vista 或 Windows XP。

服务器

需要 Windows Server 2008 或 Windows Server 2003。

标头

在 Esent.h 中声明。

Library

使用 ESENT.lib。

DLL

需要ESENT.dll。

Unicode

实现为 JetGetInstanceInfoW (Unicode) 和 JetGetInstanceInfoA (ANSI) 。

另请参阅

JET_ERR
JET_INSTANCE
JET_INSTANCE_INFO
JetFreeBuffer