LocalDBStartInstance function

Applies to:SQL Server

Belirtilen SQL Server Express LocalDB örneğini başlatır.

Header file:msoledbsql.h

Syntax

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

Arguments

pInstanceName

[Giriş] Başlatacak LocalDB örneğinin adı.

dwFlags

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

wszSqlConnection

[Çıkış] LocalDB örneğine bağlantı dizesini depolamak için arabellek.

lpcchSqlConnection

[Input/Output] On input contains the size of the wszSqlConnection buffer in characters, including any trailing nulls. Çıktıda, verilen arabellek boyutu çok küçükse, sonundaki null değerler de dahil olmak üzere gerekli arabellek boyutunu karakterler halinde içerir.

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_UNKNOWN_INSTANCE	Örnek yok.
LOCALDB_ERROR_INSUFFICIENT_BUFFER	The specified buffer wszSqlConnection is too small.
LOCALDB_ERROR_WAIT_TIMEOUT	Eşitleme kilitleri alınmaya çalışılırken zaman aşımı oluştu.
LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG	Örneğin depolanması gereken yol değerinden uzundur MAX_PATH.
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_CANNOT_CREATE_SQL_PROCESS	SQL Server için bir işlem oluşturulamaz.
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ı bozulmuş.
LOCALDB_ERROR_AUTO_INSTANCE_CREATE_FAILED	Otomatik örnek oluşturulamıyor. Hata ayrıntıları için Windows Uygulaması olay günlüğüne bakın.
LOCALDB_ERROR_INTERNAL_ERROR	Beklenmeyen bir hata oluştu. Ayrıntılar için olay günlüğüne bakın.

Details

Both the connection buffer argument (wszSqlConnection) and the connection buffer size argument (lpcchSqlConnection) are optional. Aşağıdaki tabloda, bu bağımsız değişkenleri ve bunların sonuçlarını kullanma seçenekleri gösterilmektedir.

Buffer	Buffer size	Rationale	Action
NULL	NULL	Kullanıcı örneği başlatmak istiyor ve kanal adına ihtiyacı yok.	Bir örneği başlatır (boru dönüşü yoktur ve gerekli arabellek boyutu döndürmesi yoktur).
NULL	Present	Kullanıcı çıkış arabelleği boyutunu ister. (Sonraki aramada kullanıcı büyük olasılıkla gerçek bir başlangıç isteyecektir.)	Gerekli arabellek boyutunu döndürür (başlangıç yok ve boru dönüşü yok). Sonuç: S_OK.
Present	NULL	İzin verilmiyor; yanlış giriş.	Döndürülen sonuç: LOCALDB_ERROR_INVALID_PARAMETER.
Present	Present	Kullanıcı örneği başlatmak istiyor ve başlatıldıktan sonra buna bağlanmak için kanal adına ihtiyacı var.	Arabellek boyutunu denetler, örneği başlatır ve arabellekteki kanal adını döndürür. Arabellek boyutu bağımsız değişkeni, null değerleri sonlandırmak dahil olmak üzere "server=" dizesinin uzunluğunu döndürür.

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

Related content

• SQL Server Express LocalDB üst bilgisi ve sürüm bilgileri