Función LocalDBGetInstances

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

Archivo de encabezado: sqlncli.h

Sintaxis

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

Parámetros

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
[Entrada/salida] En la entrada, contiene el número de ranuras para los nombres de instancia en el búfer pInstanceNames . En la salida, contiene el número de instancias de LocalDB que se encuentran en la estación de trabajo del usuario.

Devoluciones

S_OK
La función se ha realizado correctamente.

LOCALDB_ERROR_NOT_INSTALLED
SQL Server Express LocalDB no está instalado en el equipo.

LOCALDB_ERROR_INVALID_PARAMETER
Uno o varios 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 tener acceso a un registro de instancia.

LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
Una configuración de instancia está dañada.

LOCALDB_ERROR_INTERNAL_ERROR
Error inesperado. Consulte el registro de eventos para obtener más información.

Observaciones

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

Véase también

Información de versiones y encabezados de SQL Server Express LocalDB