LocalDBCreateInstance 関数
新しい SQL Server Express LocalDB インスタンスを作成します。
ヘッダー ファイル: sqlncli.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 リファレンス」を参照してください。