Compartilhar via


LocalDBShareInstance function

Applies to:SQL Server

Compartilha a instância especificada do LocalDB do SQL Server Express com outros usuários do computador, usando o nome compartilhado especificado.

Header file:msoledbsql.h

Syntax

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

Arguments

pOwnerSID

[Entrada] O SID do proprietário da instância.

pInstancePrivateName

[Entrada] O nome privado da instância de LocalDB a ser compartilhada.

pInstanceSharedName

[Entrada] O nome compartilhado da instância de LocalDB a ser compartilhada.

dwFlags

[Entrada] Reservado para uso futuro. No momento, deve ser definido como 0.

Returns

S_OK: a função foi bem-sucedida.

Error Description
LOCALDB_ERROR_NOT_INSTALLED O SQL Server Express LocalDB não está instalado no computador.
LOCALDB_ERROR_INVALID_PARAMETER Um ou mais parâmetros de entrada especificados são inválidos.
LOCALDB_ERROR_INVALID_INSTANCE_NAME O nome de instância especificado é inválido.
LOCALDB_ERROR_UNKNOWN_INSTANCE A instância especificada não existe.
LOCALDB_ERROR_ADMIN_RIGHTS_REQUIRED É preciso ter privilégios de administrador para executar esta operação.
LOCALDB_ERROR_SHARED_NAME_TAKEN O nome compartilhado especificado já está sendo utilizado.
LOCALDB_ERROR_INSTANCE_ALREADY_SHARED A instância especificada já está compartilhada.
LOCALDB_ERROR_INTERNAL_ERROR Erro inesperado. Consulte o log de eventos para obter detalhes.

Remarks

Para obter um exemplo de código que usa a API localdb, consulte a referência do SQL Server Express LocalDB.