Aracılığıyla paylaş


LocalDBGetInstances function

Applies to:SQL Server

Verilen sürüme sahip tüm SQL Server Express LocalDB örneklerini döndürür.

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

[Çıkış] Bu işlev döndürdüğünde, kullanıcının iş istasyonunda hem adlandırılmış hem de varsayılan LocalDB örneklerinin adlarını içerir.

lpdwNumberOfInstances

[Input/Output] On input, this option contains the number of slots for instance names in the pInstanceNames buffer. Çıktıda, bu seçenek kullanıcının iş istasyonunda bulunan LocalDB örneklerinin sayısını içerir.

Returns

S_OK: İşlev başarılı oldu.

Error Description
LOCALDB_ERROR_NOT_INSTALLED SQL Server Express LocalDB bilgisayarda yüklü değil.
LOCALDB_ERROR_INVALID_PARAMETER Belirtilen bir veya daha fazla giriş parametresi geçersiz.
LOCALDB_ERROR_INSUFFICIENT_BUFFER Giriş arabelleği çok kısa ve kesilme istenmedi.
LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG Örneğin depolanması gereken yol değerinden uzundur MAX_PATH.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY Örnek kayıt defterine erişilemiyor.
LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT Örnek yapılandırması bozuk.
LOCALDB_ERROR_INTERNAL_ERROR Beklenmeyen bir hata oluştu. Ayrıntılar için olay günlüğüne bakın.

Remarks

LocalDB API'sini kullanan bir kod örneği için bkz. SQL Server Express LocalDB başvurusu.