LocalDBShareInstance function

Applies to:SQL Server

Разделяет указанный экземпляр SQL Server Express LocalDB с другими пользователями компьютера, используя указанное общее имя.

Header file:msoledbsql.h

Syntax

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

Arguments

pOwnerSID

[Вход] Идентификатор безопасности владельца экземпляра.

pInstancePrivateName

[Вход] Частное имя разделяемого экземпляра LocalDB.

pInstanceSharedName

[Вход] Общее имя разделяемого экземпляра 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_UNKNOWN_INSTANCE	Указанный экземпляр не существует.
LOCALDB_ERROR_ADMIN_RIGHTS_REQUIRED	Для выполнения этой операции требуются права администратора.
LOCALDB_ERROR_SHARED_NAME_TAKEN	Указанное общее имя уже занято.
LOCALDB_ERROR_INSTANCE_ALREADY_SHARED	Указанный экземпляр уже используется совместно.
LOCALDB_ERROR_INTERNAL_ERROR	Произошла непредвиденная ошибка. Подробные сведения см. в журнале событий.

Remarks

Пример кода, использующий API LocalDB, см. в справочнике по SQL Server Express LocalDB.

Related content

• Сведения о заголовке и версии SQL Server Express LocalDB