Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Applies to:
SQL Server
Membuat instans SQL Server Express LocalDB baru.
Header file:msoledbsql.h
Syntax
HRESULT LocalDBCreateInstance(
PCWSTR wszVersion ,
PCWSTR pInstanceName ,
DWORD dwFlags
);
Arguments
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.
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_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 tidak terduga. Lihat log peristiwa untuk detailnya. |
Remarks
Jika instans LocalDB yang berfungsi penuh dengan nama yang ditentukan sudah ada dan versinya sama dengan atau lebih tinggi dari yang diminta, hasilnya adalah S_OK.
Dalam kasus ketika instans yang ada menjadi rusak, panggilan berikutnya ke LocalDBCreateInstance metode API 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.