次の方法で共有

LocalDBCreateInstance function

Applies to:SQL Server

新しい SQL Server Express LocalDB インスタンスを作成します。

Header file:msoledbsql.h

Syntax

HRESULT LocalDBCreateInstance(
           PCWSTR wszVersion ,
           PCWSTR pInstanceName ,
           DWORD dwFlags
);

Arguments

wszVersion

[入力] LocalDB バージョン (11. 0 や 11.0.1094.2 など)。

pInstanceName

[入力] 作成する LocalDB インスタンスの名前。

dwFlags

[入力] 将来の使用のために予約されています。 現時点では、0 に設定する必要があります。

Returns

S_OK: 関数は成功しました。

Error Description
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 予期しないエラーが発生しました。 詳細をイベント ログで確認してください。

Remarks

指定した名前の完全に機能する LocalDB インスタンスが既に存在し、そのバージョンが要求されたバージョン以上の場合、結果は S_OK。

既存のインスタンスが破損した場合、 LocalDBCreateInstance API メソッドへの後続の呼び出しは失敗します。 破損したインスタンスは、手動で修正するか明示的に削除しないと、再度使用できるようになりません。

LocalDB API を使用するコード サンプルについては、 SQL Server Express LocalDB リファレンスを参照してください。

Related content

  • Last updated on