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
一或多個指定的輸入參數無效。
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 參考。