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 标头信息和版本信息