Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Applies to:
SQL Server
Vytvoří novou instanci SQL Serveru Express LocalDB.
Header file:msoledbsql.h
Syntax
HRESULT LocalDBCreateInstance(
PCWSTR wszVersion ,
PCWSTR pInstanceName ,
DWORD dwFlags
);
Arguments
wszVersion
[Vstup] Verze LocalDB, například 11.0 nebo 11.0.1094.2.
pInstanceName
[Vstup] Název instance LocalDB, která se má vytvořit.
dwFlags
[Vstup] Vyhrazeno pro budoucí použití. Aktuálně by mělo být nastaveno na hodnotu 0.
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_INSTANCE_FOLDER_PATH_TOO_LONG | Cesta, ve které má být instance uložena, je delší než MAX_PATH. |
| LOCALDB_ERROR_INSTANCE_EXISTS_WITH_LOWER_VERSION | Zadaná instance již existuje, ale její verze je nižší než požadovaná. |
| LOCALDB_ERROR_UNKNOWN_VERSION | Zadaná verze není dostupná. |
| LOCALDB_ERROR_VERSION_REQUESTED_NOT_INSTALLED | Zadaná úroveň opravy není nainstalovaná. |
| LOCALDB_ERROR_CANNOT_CREATE_INSTANCE_FOLDER | Složku nelze vytvořit v části %userprofile%. |
| 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_SQL_SERVER_STARTUP_FAILED | Spustí se proces SQL Serveru, ale spuštění SQL Serveru se nezdařilo. |
| 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
Pokud plně funkční instance LocalDB se zadaným názvem již existuje a její verze je rovna nebo vyšší, než je požadováno, výsledek je S_OK.
V případech, kdy dojde k poškození existující instance, následná volání LocalDBCreateInstance metody rozhraní API selžou. Poškozené instance musí být opraveny ručně nebo explicitně odstraněny, aby je bylo možné znovu použít.
Ukázku kódu, která používá rozhraní LocalDB API, najdete v referenčních informacích k SQL Serveru Express LocalDB.