Función LocalDBGetInstances

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

Archivo de encabezado: sqlncli.h

Sintaxis

#define MAX_LOCALDB_INSTANCE_NAME_LENGTH 128
typedef WCHAR TLocalDBInstanceName[MAX_LOCALDB_INSTANCE_NAME_LENGTH + 1];
typedef TLocalDBInstanceName* PTLocalDBInstanceName;

HRESULT LocalDBGetInstances(
           PTLocalDBInstanceName pInstanceNames,
           LPDWORD lpdwNumberOfInstances
);

Parámetros

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

• lpdwNumberOfInstances
  [Entrada/Salida] En la entrada, contiene el número de zonas para los nombres de instancia en el búfer de pInstanceNames. En la salida, contiene el número de instancias de LocalDB que se encontraron en la estación de trabajo del usuario.

Devuelve

• 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 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 ha solicitado truncamiento.

• LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG
  La ruta de acceso donde la instancia debe almacenarse es mayor que MAX_PATH.

• LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY
  No se puede tener acceso a un registro de la instancia.

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

• LOCALDB_ERROR_INTERNAL_ERROR
  Se ha producido un error imprevisto. Vea el registro de eventos para obtener detalles.

Comentarios

Para obtener un ejemplo de código que utilice LocalDB API, vea Referencia de SQL Server Express LocalDB.

Vea también

Conceptos

Información de encabezado y versión de SQL Server Express LocalDB