Función JetGetInstanceInfo

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