Aracılığıyla paylaş


LocalDBCreateInstance function

Applies to:SQL Server

Yeni bir SQL Server Express LocalDB örneği oluşturur.

Header file:msoledbsql.h

Syntax

HRESULT LocalDBCreateInstance(
           PCWSTR wszVersion ,
           PCWSTR pInstanceName ,
           DWORD dwFlags
);

Arguments

wszVersion

[Giriş] LocalDB sürümü, örneğin 11.0 veya 11.0.1094.2.

pInstanceName

[Giriş] Oluşturulacak LocalDB örneğinin adı.

dwFlags

[Giriş] Gelecekte kullanmak üzere ayrılmıştır. Şu anda 0 olarak ayarlanmalıdır.

Returns

S_OK: İşlev başarılı oldu.

Error Description
LOCALDB_ERROR_NOT_INSTALLED SQL Server Express LocalDB bilgisayarda yüklü değil.
LOCALDB_ERROR_INVALID_PARAMETER Belirtilen bir veya daha fazla giriş parametresi geçersiz.
LOCALDB_ERROR_INVALID_INSTANCE_NAME Belirtilen örnek adı geçersiz.
LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG Örneğin depolanması gereken yol MAX_PATH daha uzundur.
LOCALDB_ERROR_INSTANCE_EXISTS_WITH_LOWER_VERSION Belirtilen örnek zaten var, ancak sürümü istenenden daha düşük.
LOCALDB_ERROR_UNKNOWN_VERSION Belirtilen sürüm kullanılamıyor.
LOCALDB_ERROR_VERSION_REQUESTED_NOT_INSTALLED Belirtilen düzeltme eki düzeyi yüklü değil.
LOCALDB_ERROR_CANNOT_CREATE_INSTANCE_FOLDER altında %userprofile%bir klasör oluşturulamaz.
LOCALDB_ERROR_CANNOT_GET_USER_PROFILE_FOLDER Kullanıcı profili klasörü alınamıyor.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_FOLDER Örnek klasörüne erişilemiyor.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY Örnek kayıt defterine erişilemiyor.
LOCALDB_ERROR_CANNOT_MODIFY_INSTANCE_REGISTRY Örnek kayıt defteri değiştirilemez.
LOCALDB_ERROR_SQL_SERVER_STARTUP_FAILED SQL Server işlemi başlatıldı ancak SQL Server başlatılamadı.
LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT Örnek yapılandırması bozuk.
LOCALDB_ERROR_INTERNAL_ERROR Beklenmeyen bir hata oluştu. Ayrıntılar için olay günlüğüne bakın.

Remarks

Belirtilen ada sahip tam işlevsel bir LocalDB örneği zaten varsa ve sürümü istenenden eşit veya daha yüksekse, sonuç olur S_OK.

Mevcut bir örneğin bozulması durumunda API yöntemine yapılan LocalDBCreateInstance sonraki çağrılar başarısız olur. Bozuk örneklerin yeniden kullanılabilmesi için el ile düzeltilmesi veya açıkça silinmesi gerekir.

LocalDB API'sini kullanan bir kod örneği için bkz. SQL Server Express LocalDB başvurusu.