Dela via

LocalDBGetInstances function

Applies to:SQL Server

Returnerar alla SQL Server Express LocalDB-instanser med den angivna versionen.

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

[Utdata] När den här funktionen returneras innehåller namnen på både namngivna och standardinstanser av LocalDB på användarens arbetsstation.

lpdwNumberOfInstances

[Input/Output] On input, this option contains the number of slots for instance names in the pInstanceNames buffer. Vid utdata innehåller det här alternativet antalet LocalDB-instanser som finns på användarens arbetsstation.

Returns

S_OK: Funktionen lyckades.

Error Description
LOCALDB_ERROR_NOT_INSTALLED SQL Server Express LocalDB är inte installerat på datorn.
LOCALDB_ERROR_INVALID_PARAMETER En eller flera angivna indataparametrar är ogiltiga.
LOCALDB_ERROR_INSUFFICIENT_BUFFER Indatabufferten är för kort och trunkering begärdes inte.
LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG Sökvägen där instansen ska lagras är längre än MAX_PATH.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY Det går inte att komma åt ett instansregister.
LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT En instanskonfiguration är skadad.
LOCALDB_ERROR_INTERNAL_ERROR Ett oväntat fel uppstod. Mer information finns i händelseloggen.

Remarks

Ett kodexempel som använder LocalDB API finns i SQL Server Express LocalDB-referens.

Related content