Fungsi LocalDBStopInstance

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

File header: sqlncli.h

Sintaksis

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

Parameter-parameternya

pInstanceName
[Input] Nama instans LocalDB untuk dihentikan.

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

Bendera yang tersedia:

LOCALDB_SHUTDOWN_KILL_PROCESS
Matikan segera menggunakan perintah matikan sistem operasi proses.

LOCALDB_SHUTDOWN_WITH_NOWAIT
Matikan menggunakan opsi WITH NOWAIT Transact-SQL perintah.

Jika tidak ada bendera yang diatur, instans LocalDB akan dimatikan menggunakan perintah SHUTDOWN Transact-SQL. Jika kedua bendera diatur, bendera LOCALDB_SHUTDOWN_KILL_PROCESS 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.

Pengembalian Barang

S_OK
Fungsi berhasil.

LOCALDB_ERROR_NOT_INSTALLED
SQL Server Express LocalDB tidak diinstal pada 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 tak terduga. Lihat log peristiwa untuk detailnya.

Komentar

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

Lihat Juga

Informasi Header dan Versi SQL Server Express LocalDB