Bagikan melalui


LocalDBGetInstances function

Applies to:SQL Server

Mengembalikan semua instans SQL Server Express LocalDB dengan versi yang diberikan.

Header file:msoledbsql.h

Syntax

#define MAX_LOCALDB_INSTANCE_NAME_LENGTH 128typedef WCHAR TLocalDBInstanceName [ MAX_LOCALDB_INSTANCE_NAME_LENGTH + 1 ] ;
typedef TLocalDBInstanceName* PTLocalDBInstanceName;
HRESULT LocalDBGetInstances(
           PTLocalDBInstanceName pInstanceNames ,
           LPDWORD lpdwNumberOfInstances
);

Arguments

pInstanceNames

[Output] Saat fungsi ini kembali, berisi nama instans LocalDB bernama dan default di stasiun kerja pengguna.

lpdwNumberOfInstances

[Input/Output] On input, this option contains the number of slots for instance names in the pInstanceNames buffer. Pada output, opsi ini berisi jumlah instans LocalDB yang ditemukan di stasiun kerja pengguna.

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_INSUFFICIENT_BUFFER Buffer input terlalu pendek, dan pemotongan tidak diminta.
LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG Jalur tempat instans harus disimpan lebih panjang dari MAX_PATH.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY Registri instans tidak dapat diakses.
LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT Konfigurasi instans rusak.
LOCALDB_ERROR_INTERNAL_ERROR Terjadi kesalahan tidak terduga. Lihat log peristiwa untuk detailnya.

Remarks

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