Fungsi LocalDBStartInstance

Memulai instans SQL Server Express LocalDB yang ditentukan.

File header: sqlncli.h

Sintaksis

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

Parameter-parameternya

pInstanceName
[Input] Nama instans LocalDB untuk memulai.

dwFlags
[Input] Dicadangkan untuk digunakan di masa mendatang. Saat ini harus diatur ke 0.

wszSqlConnection
[Output] Buffer untuk menyimpan string koneksi ke instans LocalDB.

lpcchSqlConnection
[Input/Output] Pada input berisi ukuran buffer wszSqlConnection dalam karakter, termasuk null berikutnya. Pada output, jika ukuran buffer yang diberikan terlalu kecil, berisi ukuran buffer yang diperlukan dalam karakter, termasuk null berikutnya.

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_INSUFFICIENT_BUFFER
Buffer wszSqlConnection yang ditentukan terlalu kecil.

LOCALDB_ERROR_WAIT_TIMEOUT
Waktu habis terjadi saat mencoba memperoleh kunci sinkronisasi.

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_CANNOT_MODIFY_INSTANCE_REGISTRY
Registri instans tidak dapat dimodifikasi.

LOCALDB_ERROR_CANNOT_CREATE_SQL_PROCESS
Proses untuk SQL Server tidak dapat dibuat.

LOCALDB_ERROR_SQL_SERVER_STARTUP_FAILED
Proses SQL Server dimulai, tetapi startup SQL Server gagal.

LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
Konfigurasi instans rusak.

LOCALDB_ERROR_AUTO_INSTANCE_CREATE_FAILED
Tidak dapat membuat instans otomatis. Lihat log peristiwa Aplikasi Windows untuk detail kesalahan.

LOCALDB_ERROR_INTERNAL_ERROR
Terjadi kesalahan tak terduga. Lihat log peristiwa untuk detailnya.

Detail lebih lanjut

Argumen buffer koneksi (wszSqlConnection) dan argumen ukuran buffer koneksi (lpcchSqlConnection) bersifat opsional. Tabel berikut ini memperlihatkan opsi untuk menggunakan argumen ini dan hasilnya.

Penampung	Ukuran buffer	Alasan	Tindakan
NOL	NOL	Pengguna ingin memulai instans dan tidak memerlukan nama pipa.	Memulai instans (tidak ada pengembalian pipa dan tidak ada pengembalian ukuran buffer yang diperlukan).
NOL	Hadiah	Pengguna meminta ukuran buffer output. (Dalam panggilan berikutnya, pengguna mungkin akan meminta permulaan aktual.)	Mengembalikan ukuran buffer yang diperlukan (tidak ada awal dan tidak ada pengembalian pipa). Hasilnya S_OK.
Hadiah	NOL	Dilarang; input yang salah.	Hasil yang dikembalikan LOCALDB_ERROR_INVALID_PARAMETER.
Hadiah	Hadiah	Pengguna ingin memulai instans dan memerlukan nama pipa untuk menyambungkannya setelah dimulai.	Memeriksa ukuran buffer, memulai instans, dan mengembalikan nama pipa di buffer. Argumen ukuran buffer mengembalikan panjang string "server=", tidak termasuk mengakhiri null.

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

Lihat Juga

Informasi Header dan Versi SQL Server Express LocalDB