LocalDBShareInstance 函數

使用指定的共用名稱，與電腦的其他使用者共用指定的 SQL Server Express LocalDB 執行個體。

標頭檔：sqlncli.h

語法

HRESULT LocalDBShareInstance(
           PSID pOwnerSID,
           PCWSTR pInstancePrivateName,
           PCWSTR pInstanceSharedName, 
           DWORD dwFlags 
);

參數

• pOwnerSID
  [輸入] 執行個體擁有者的 SID。

• pInstancePrivateName
  [輸入] 要共用之 LocalDB 執行個體的私用名稱。

• pInstanceSharedName
  [輸入] 要共用之 LocalDB 執行個體的共用名稱。

• dwFlags
  [輸入] 保留供日後使用。 目前應設為 0。

傳回值

• S_OK
  此函數已成功。

• LOCALDB_ERROR_NOT_INSTALLED
  SQL Server Express LocalDB 未安裝在電腦上。

• LOCALDB_ERROR_INVALID_PARAMETER
  一個或多個指定的輸入參數無效。

• LOCALDB_ERROR_INVALID_INSTANCE_NAME
  指定的執行個體名稱無效。

• LOCALDB_ERROR_UNKNOWN_INSTANCE
  指定的執行個體不存在。

• LOCALDB_ERROR_ADMIN_RIGHTS_REQUIRED
  您必須擁有管理員權限才能執行這項作業。

• LOCALDB_ERROR_SHARED_NAME_TAKEN
  指定的共用名稱已被使用。

• LOCALDB_ERROR_INSTANCE_ALREADY_SHARED
  已共用指定的執行個體。

• LOCALDB_ERROR_INTERNAL_ERROR
  發生意外的錯誤。 請參閱事件記錄檔，以取得詳細資料。

備註

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

請參閱

概念

SQL Server Express LocalDB 標頭和版本資訊