Sdílet prostřednictvím

LocalDBStartInstance function

Applies to:SQL Server

Spustí zadanou instanci SQL Serveru Express LocalDB.

Header file:msoledbsql.h

Syntax

HRESULT LocalDBStartInstance(
           PCWSTR pInstanceName ,
           DWORD dwFlags ,
           LPWSTR wszSqlConnection ,
           LPDWORD lpcchSqlConnection
);

Arguments

pInstanceName

[Vstup] Název instance LocalDB, která se má spustit.

dwFlags

[Vstup] Vyhrazeno pro budoucí použití. Aktuálně by mělo být nastaveno na hodnotu 0.

wszSqlConnection

[Výstup] Vyrovnávací paměť pro uložení připojovacího řetězce do instance LocalDB.

lpcchSqlConnection

[Input/Output] On input contains the size of the wszSqlConnection buffer in characters, including any trailing nulls. Pokud je daná velikost vyrovnávací paměti ve výstupu příliš malá, obsahuje v znacích požadovanou velikost vyrovnávací paměti včetně všech koncových hodnot null.

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_INVALID_INSTANCE_NAME Zadaný název instance je neplatný.
LOCALDB_ERROR_UNKNOWN_INSTANCE Instance neexistuje.
LOCALDB_ERROR_INSUFFICIENT_BUFFER The specified buffer wszSqlConnection is too small.
LOCALDB_ERROR_WAIT_TIMEOUT Při pokusu o získání zámků synchronizace došlo k vypršení časového limitu.
LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG Cesta, ve které má být instance uložena, je delší než MAX_PATH.
LOCALDB_ERROR_CANNOT_GET_USER_PROFILE_FOLDER Složku profilu uživatele nelze načíst.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_FOLDER Nelze získat přístup ke složce instance.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY Nelze získat přístup k registru instance.
LOCALDB_ERROR_CANNOT_MODIFY_INSTANCE_REGISTRY Registr instance nelze upravit.
LOCALDB_ERROR_CANNOT_CREATE_SQL_PROCESS Proces pro SQL Server nelze vytvořit.
LOCALDB_ERROR_SQL_SERVER_STARTUP_FAILED Spustil se proces SQL Serveru, ale spuštění SQL Serveru se nezdařilo.
LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT Konfigurace instance byla poškozena.
LOCALDB_ERROR_AUTO_INSTANCE_CREATE_FAILED Nejde vytvořit automatickou instanci. Podrobnosti o chybě najdete v protokolu událostí aplikace systému Windows.
LOCALDB_ERROR_INTERNAL_ERROR Došlo k neočekávané chybě. Podrobnosti najdete v protokolu událostí.

Details

Both the connection buffer argument (wszSqlConnection) and the connection buffer size argument (lpcchSqlConnection) are optional. V následující tabulce jsou uvedeny možnosti použití těchto argumentů a jejich výsledků.

Buffer Buffer size Rationale Action
NULL NULL Uživatel chce spustit instanci a nepotřebuje název kanálu. Spustí instanci (žádná návratová čára a žádná požadovaná návratová velikost vyrovnávací paměti).
NULL Present Uživatel požádá o velikost výstupní vyrovnávací paměti. (V dalším hovoru se uživatel pravděpodobně zeptá na skutečný začátek.) Vrátí požadovanou velikost vyrovnávací paměti (žádný začátek a návrat potrubí). Výsledek je S_OK.
Present NULL Nepovoleno; nesprávný vstup. Vrácený výsledek je LOCALDB_ERROR_INVALID_PARAMETER.
Present Present Uživatel chce spustit instanci a potřebuje název kanálu, aby se k ní po spuštění připojil. Zkontroluje velikost vyrovnávací paměti, spustí instanci a vrátí název kanálu v vyrovnávací paměti.
Argument velikost vyrovnávací paměti vrátí délku řetězce "server=", který nezahrnuje ukončování hodnot null.

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

Related content

  • Last updated on