新しい 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 リファレンス」を参照してください。