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_INSTANCE_EXISTS_WITH_LOWER_VERSION
指定的實例已經存在，但其版本低於要求。

LOCALDB_ERROR_UNKNOWN_VERSION
指定的版本無法使用。

LOCALDB_ERROR_CANNOT_CREATE_INSTANCE_FOLDER
無法在 %userprofile% 下建立資料夾。

LOCALDB_ERROR_SQL_SERVER_STARTUP_FAILED
SQL Server 進程已啟動，但 SQL Server 啟動失敗。

LOCALDB_ERROR_INTERNAL_ERROR
發生未預期的錯誤。如需詳細資訊，請參閱事件記錄檔。

如果具有指定名稱的完整 LocalDB 實例已經存在，且其版本等於或高於要求，則結果會S_OK。

如果現有實例損毀，則對 LocalDBCreateInstance API 方法的 後續呼叫將會失敗。損毀的實例必須手動或明確刪除，才能再次使用。

如需使用 LocalDB API 的程式碼範例，請參閱 SQL Server Express LocalDB 參考。