Applies to:
SQL Server
指定したバージョンのすべての SQL Server Express LocalDB インスタンスを返します。
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
[出力]この関数から制御が戻るときに、ユーザーのワークステーション上の名前付き LocalDB インスタンスと既定の LocalDB インスタンスの両方の名前が格納されます。
lpdwNumberOfInstances
[Input/Output] On input, this option contains the number of slots for instance names in the pInstanceNames buffer. 出力時に、このオプションには、ユーザーのワークステーションで見つかった LocalDB インスタンスの数が含まれます。
Returns
S_OK: 関数は成功しました。
| Error | Description |
|---|---|
| LOCALDB_ERROR_NOT_INSTALLED | SQL Server Express LocalDB がコンピューターにインストールされていません。 |
| LOCALDB_ERROR_INVALID_PARAMETER | 指定した 1 つまたは複数の入力パラメーターが無効です。 |
| LOCALDB_ERROR_INSUFFICIENT_BUFFER | 入力バッファーが短すぎて、切り捨てが要求されませんでした。 |
| LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG | インスタンスを格納する必要があるパスが、 MAX_PATHよりも長くなっています。 |
| LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY | インスタンス レジストリにアクセスできません。 |
| LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT | インスタンス構成が破損しています。 |
| LOCALDB_ERROR_INTERNAL_ERROR | 予期しないエラーが発生しました。 詳細をイベント ログで確認してください。 |
Remarks
LocalDB API を使用するコード サンプルについては、 SQL Server Express LocalDB リファレンスを参照してください。