Compartir a través de


LocalDBGetInstances function

Applies to:SQL Server

Devuelve todas las instancias de SQL Server Express LocalDB con la versión indicada.

Header file:msoledbsql.h

Syntax

#define MAX_LOCALDB_INSTANCE_NAME_LENGTH 128typedef WCHAR TLocalDBInstanceName [ MAX_LOCALDB_INSTANCE_NAME_LENGTH + 1 ] ;
typedef TLocalDBInstanceName* PTLocalDBInstanceName;
HRESULT LocalDBGetInstances(
           PTLocalDBInstanceName pInstanceNames ,
           LPDWORD lpdwNumberOfInstances
);

Arguments

pInstanceNames

[Salida] Cuando se devuelve esta función, contiene los nombres de las instancias de LocalDB con nombre y predeterminadas en la estación de trabajo del usuario.

lpdwNumberOfInstances

[Input/Output] On input, this option contains the number of slots for instance names in the pInstanceNames buffer. En la salida, esta opción contiene el número de instancias de LocalDB que se encuentran en la estación de trabajo del usuario.

Returns

S_OK: la función se realizó correctamente.

Error Description
LOCALDB_ERROR_NOT_INSTALLED SQL Server Express LocalDB no está instalado en el equipo.
LOCALDB_ERROR_INVALID_PARAMETER Uno o más parámetros de entrada especificados no son válidos.
LOCALDB_ERROR_INSUFFICIENT_BUFFER El búfer de entrada es demasiado corto y no se solicitó el truncamiento.
LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG La ruta de acceso donde se debe almacenar la instancia es mayor que MAX_PATH.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY No se puede acceder a un registro de instancia.
LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT Una configuración de instancia está dañada.
LOCALDB_ERROR_INTERNAL_ERROR Se ha producido un error inesperado. Vea el registro de eventos para obtener detalles.

Remarks

Para obtener un ejemplo de código que usa la API de LocalDB, consulte Referencia de SQL Server Express LocalDB.