LocalDBCreateInstance 関数
適用対象: 
SQL Server
新しい SQL Server Express LocalDB インスタンスを作成します。
ヘッダー ファイル: msoledbsql.h
構文
HRESULT LocalDBCreateInstance(
PCWSTR wszVersion,
PCWSTR pInstanceName,
DWORD dwFlags
);
パラメーター
wszVersion
[入力] LocalDB バージョン (11. 0 や 11.0.1094.2 など)。
pInstanceName
[入力] 作成する LocalDB インスタンスの名前。
dwFlags
[入力] 将来の使用のために予約されています。 現時点では、0 に設定する必要があります。
返品
S_OK
関数が正常に実行されました。
LOCALDB_ERROR_NOT_INSTALLED
SQL Server Express LocalDB は、コンピューターにインストールされていません。
LOCALDB_ERROR_INVALID_PARAMETER
指定した 1 つまたは複数の入力パラメーターが無効です。
LOCALDB_ERROR_INVALID_INSTANCE_NAME
指定したインスタンス名は無効です。
LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG
インスタンスを格納するパスの長さが MAX_PATH を超過しています。
LOCALDB_ERROR_INSTANCE_EXISTS_WITH_LOWER_VERSION
指定したインスタンスは既に存在しますが、そのバージョンは要求よりも低いバージョンです。
LOCALDB_ERROR_UNKNOWN_VERSION
指定したバージョンは使用できません。
LOCALDB_ERROR_VERSION_REQUESTED_NOT_INSTALLED
指定したパッチ レベルはインストールされていません。
LOCALDB_ERROR_CANNOT_CREATE_INSTANCE_FOLDER
%userprofile% の下にはフォルダーを作成できません。
LOCALDB_ERROR_CANNOT_GET_USER_PROFILE_FOLDER
ユーザー プロファイル フォルダーを取得できません。
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_FOLDER
インスタンス フォルダーにアクセスできません。
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY
インスタンス レジストリにアクセスできません。
LOCALDB_ERROR_CANNOT_MODIFY_INSTANCE_REGISTRY
インスタンス レジストリを変更できません。
LOCALDB_ERROR_SQL_SERVER_STARTUP_FAILED
SQL Server プロセスが開始されましたが、SQL Server の起動に失敗しました。
LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
インスタンス構成が破損しています。
LOCALDB_ERROR_INTERNAL_ERROR
予期しないエラーが発生しました。 詳細をイベント ログで確認してください。
解説
指定の名前を持つ完全に機能する LocalDB インスタンスが既にあり、そのバージョンが要求されたバージョン以上である場合、結果は S_OK です。
既存のインスタンスが破損した場合、 LocalDBCreateInstance API メソッドへの後続の呼び出しは失敗します。 破損したインスタンスは、手動で修正するか明示的に削除しないと、再度使用できるようになりません。
LocalDB API を使用するコード サンプルについては、「 SQL Server Express LocalDB リファレンスを参照してください。