Aracılığıyla paylaş


LocalDBStopInstance function

Applies to:SQL Server

Belirtilen SQL Server Express LocalDB örneğinin çalışmasını durdurur.

Header file:msoledbsql.h

Syntax

HRESULT LocalDBStopInstance(
           PCWSTR pInstanceName ,
           DWORD dwFlags ,
           ULONG ulTimeout
);

Arguments

pInstanceName

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

dwFlags

[Giriş] Örneği durdurmanın yolunu belirten bayrak değerlerinin bir veya bir bileşimi.

Available flags:

LOCALDB_SHUTDOWN_KILL_PROCESS

sonlandırma işlemi işletim sistemi komutunu kullanarak hemen kapatın.

LOCALDB_SHUTDOWN_WITH_NOWAIT

Transact-SQL seçeneğini kullanarak WITH NOWAIT kapatın.

Bayraklardan hiçbiri ayarlı değilse, LocalDB örneği Transact-SQL komutu kullanılarak SHUTDOWN kapatılır. Her iki bayrak da ayarlanırsa, LOCALDB_SHUTDOWN_KILL_PROCESS bayrak öncelikli olur.

ulTimeout

[Giriş] Saniye cinsinden bu işlemin tamamlanmasını bekleme süresi. Bu değer ise 0, bu işlev LocalDB örneğinin durmasını beklemeden hemen döner.

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_WAIT_TIMEOUT Eşitleme kilitleri alınmaya çalışılırken zaman aşımı oluştu.
LOCALDB_ERROR_INSTANCE_STOP_FAILED Durdurma işlemi belirtilen süre içinde tamamlanamadı.
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_INSTANCE_CONFIGURATION_CORRUPT Örnek yapılandırması bozuk.
LOCALDB_ERROR_CALLER_IS_NOT_OWNER API çağıranı LocalDB örneği sahibi değildir.
LOCALDB_ERROR_INTERNAL_ERROR Beklenmeyen bir hata oluştu. Ayrıntılar için olay günlüğüne bakın.

Remarks

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