LocalDBStartInstance function

Applies to:SQL Server

Memulai instans SQL Server Express LocalDB yang ditentukan.

Header file:msoledbsql.h

Syntax

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

Arguments

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] On input contains the size of the wszSqlConnection buffer in characters, including any trailing nulls. Pada output, jika ukuran buffer yang diberikan terlalu kecil, berisi ukuran buffer yang diperlukan dalam karakter, termasuk null berikutnya.

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_INSUFFICIENT_BUFFER	The specified buffer wszSqlConnection is too small.
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 tidak terduga. Lihat log peristiwa untuk detailnya.

Details

Both the connection buffer argument (wszSqlConnection) and the connection buffer size argument (lpcchSqlConnection) are optional. Tabel berikut ini memperlihatkan opsi untuk menggunakan argumen ini dan hasilnya.

Buffer	Buffer size	Rationale	Action
NULL	NULL	Pengguna ingin memulai instans dan tidak memerlukan nama pipa.	Memulai instans (tidak ada pengembalian pipa dan tidak ada pengembalian ukuran buffer yang diperlukan).
NULL	Present	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 adalah S_OK.
Present	NULL	Dilarang; input yang salah.	Hasil yang dikembalikan adalah LOCALDB_ERROR_INVALID_PARAMETER.
Present	Present	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.

Related content

• Informasi header dan versi SQL Server Express LocalDB