Función JetGetInstanceInfo

  • Artículo

Se aplica a: Windows | Windows Server

Función JetGetInstanceInfo

La función JetGetInstanceInfo recupera información sobre las instancias que se ejecutan.

Windows XP: JetGetInstanceInfo se presenta en Windows XP.

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

Parámetros

pcInstanceInfo

Puntero a un búfer que recibirá el número de elementos almacenados en paInstanceInfo.

paInstanceInfo

Puntero a un búfer que recibirá la dirección del primer elemento de una matriz de estructuras.

Valor devuelto

Esta función devuelve el tipo de datos JET_ERR con uno de los siguientes códigos de retorno. Para obtener más información sobre los posibles errores de ESE, vea Extensible Storage Engine Errors and Error Handling Parameters.

Código devuelto

Descripción

JET_errSuccess

La operación se ha completado correctamente.

JET_errInvalidParameter

Uno de los parámetros proporcionados contenía un valor inesperado o contenía un valor que no tenía sentido cuando se combinaba con el valor de otro parámetro. JetGetInstanceInfo devolverá este error cuando:

  • pcInstanceInfo o paInstanceInfo son NULL.

JET_errOutOfMemory

No hay memoria suficiente para procesar la solicitud.

Observaciones

El motor de base de datos asignará una matriz de estructuras JET_INSTANCE_INFO . El autor de la llamada es responsable de liberar esta memoria con JetFreeBuffer.

Si no hay ninguna instancia activa, JetGetInstanceInfo devolverá JET_errSuccess y pcInstanceInfo recibirá un valor de 0.

Requisitos

Requisito Value

Cliente

Requiere Windows Vista o Windows XP.

Servidor

Requiere Windows Server 2008 o Windows Server 2003.

Encabezado

Declarado en Esent.h.

Library

Use ESENT.lib.

Archivo DLL

Requiere ESENT.dll.

Unicode

Se implementa como JetGetInstanceInfoW (Unicode) y JetGetInstanceInfoA (ANSI).

Consulte también

JET_ERR
JET_INSTANCE
JET_INSTANCE_INFO
JetFreeBuffer