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 | 一或多個指定的輸入參數無效。 |
| 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。
如果現有實例損毀，則 API 方法的 LocalDBCreateInstance 後續呼叫會失敗。 損毀的實例必須手動或明確刪除，才能再次使用。
如需使用 LocalDB API 的程式碼範例，請參閱 SQL Server Express LocalDB 參考。