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