LocalDBStopInstance function

Applies to:SQL Server

Menghentikan instans SQL Server Express LocalDB yang ditentukan agar tidak berjalan.

Header file:msoledbsql.h

Syntax

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

Arguments

pInstanceName

[Input] Nama instans LocalDB untuk dihentikan.

dwFlags

[Input] Satu atau kombinasi nilai bendera yang menentukan cara menghentikan instans.

Available flags:

LOCALDB_SHUTDOWN_KILL_PROCESS

Matikan segera menggunakan perintah hentikan sistem operasi proses.

LOCALDB_SHUTDOWN_WITH_NOWAIT

Matikan menggunakan WITH NOWAIT opsi Transact-SQL perintah.

Jika tidak ada bendera yang diatur, instans LocalDB akan dimatikan menggunakan SHUTDOWN perintah Transact-SQL. Jika kedua bendera diatur, LOCALDB_SHUTDOWN_KILL_PROCESS bendera diutamakan.

ulTimeout

[Input] Waktu dalam detik untuk menunggu operasi ini selesai. Jika nilai ini adalah 0, fungsi ini akan segera kembali tanpa menunggu instans LocalDB berhenti.

Returns

S_OK: Fungsi berhasil.

Error	Description
LOCALDB_ERROR_NOT_INSTALLED	SQL Server Express LocalDB tidak diinstal di komputer.
LOCALDB_ERROR_INVALID_PARAMETER	Satu atau beberapa parameter input yang ditentukan tidak valid.
LOCALDB_ERROR_INVALID_INSTANCE_NAME	Nama instans yang ditentukan tidak valid.
LOCALDB_ERROR_UNKNOWN_INSTANCE	Instans tidak ada.
LOCALDB_ERROR_WAIT_TIMEOUT	Waktu habis terjadi saat mencoba memperoleh kunci sinkronisasi.
LOCALDB_ERROR_INSTANCE_STOP_FAILED	Operasi berhenti gagal diselesaikan dalam waktu tertentu.
LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG	Jalur tempat instans harus disimpan lebih panjang dari MAX_PATH.
LOCALDB_ERROR_CANNOT_GET_USER_PROFILE_FOLDER	Folder profil pengguna tidak dapat diambil.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_FOLDER	Folder instans tidak dapat diakses.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY	Registri instans tidak dapat diakses.
LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT	Konfigurasi instans rusak.
LOCALDB_ERROR_CALLER_IS_NOT_OWNER	Pemanggil API bukan pemilik instans LocalDB.
LOCALDB_ERROR_INTERNAL_ERROR	Terjadi kesalahan tidak terduga. Lihat log peristiwa untuk detailnya.

Remarks

Untuk sampel kode yang menggunakan API LocalDB, lihat referensi SQL Server Express LocalDB.

Related content

• Informasi header dan versi SQL Server Express LocalDB