Fungsi LocalDBCreateInstance

Membuat instans SQL Server Express LocalDB baru.

File header: sqlncli.h

Sintaksis

HRESULT LocalDBCreateInstance(  
           PCWSTR wszVersion,  
           PCWSTR pInstanceName,   
           DWORD dwFlags   
);  

Parameter-parameternya

wszVersion
[Input] Versi LocalDB, misalnya 11.0 atau 11.0.1094.2.

pInstanceName
[Input] Nama untuk instans LocalDB yang akan dibuat.

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

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_INSTANCE_FOLDER_PATH_TOO_LONG
Jalur tempat instans harus disimpan lebih panjang dari MAX_PATH.

LOCALDB_ERROR_INSTANCE_EXISTS_WITH_LOWER_VERSION
Instans yang ditentukan sudah ada tetapi versinya lebih rendah dari yang diminta.

LOCALDB_ERROR_UNKNOWN_VERSION
Versi yang ditentukan tidak tersedia.

LOCALDB_ERROR_VERSION_REQUESTED_NOT_INSTALLED
Tingkat patch yang ditentukan tidak diinstal.

LOCALDB_ERROR_CANNOT_CREATE_INSTANCE_FOLDER
Folder tidak dapat dibuat di bawah %userprofile%.

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_SQL_SERVER_STARTUP_FAILED
Proses SQL Server dimulai tetapi startup SQL Server gagal.

LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
Konfigurasi instans rusak.

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

Komentar

Jika instans LocalDB yang berfungsi penuh dengan nama yang ditentukan sudah ada dan versinya sama dengan atau lebih tinggi dari yang diminta, hasilnya S_OK.

Dalam kasus ketika instans yang ada menjadi rusak, panggilan berikutnya ke LocalDBCreateInstance metode API akan gagal. Instans yang rusak harus diperbaiki secara manual atau dihapus secara eksplisit sebelum dapat digunakan lagi.

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

Lihat Juga

Informasi Header dan Versi SQL Server Express LocalDB