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 メソッドの後続の呼び出しは失敗します。破損したインスタンスは、手動で修正するか明示的に削除しないと、再度使用できるようになりません。