LocalDBGetInstances function

Applies to:SQL Server

Vrátí všechny instance SQL Server Express LocalDB s danou verzí.

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

[Výstup] Když tato funkce vrátí, obsahuje názvy pojmenovaných i výchozích instancí LocalDB na pracovní stanici uživatele.

lpdwNumberOfInstances

[Input/Output] On input, this option contains the number of slots for instance names in the pInstanceNames buffer. Ve výstupu tato možnost obsahuje počet instancí LocalDB nalezených na pracovní stanici uživatele.

Returns

S_OK: Funkce byla úspěšná.

Error	Description
LOCALDB_ERROR_NOT_INSTALLED	SQL Server Express LocalDB není v počítači nainstalovaný.
LOCALDB_ERROR_INVALID_PARAMETER	Jeden nebo více zadaných vstupních parametrů je neplatný.
LOCALDB_ERROR_INSUFFICIENT_BUFFER	Vstupní vyrovnávací paměť je příliš krátká a nebylo požadováno zkrácení.
LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG	Cesta, ve které má být instance uložena, je delší než MAX_PATH.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY	Nelze získat přístup k registru instance.
LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT	Konfigurace instance je poškozena.
LOCALDB_ERROR_INTERNAL_ERROR	Došlo k neočekávané chybě. Podrobnosti najdete v protokolu událostí.

Remarks

Ukázku kódu, která používá rozhraní LocalDB API, najdete v referenčních informacích k SQL Serveru Express LocalDB.

Related content

• Informace o hlavičce a verzi SQL Serveru Express LocalDB