Partilhar via


Função LocalDBShareInstance

Aplica-se: SQL Server

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

Arquivo de cabeçalho: msoledbsql.h

Sintaxe

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

Parâmetros

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. Atualmente deve ser definido como 0.

Devoluções

S_OK
A função foi bem-sucedida.

LOCALDB_ERROR_NOT_INSTALLED
O LocalDB do SQL Server Express 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.

Comentários

Para obter uma amostra do código que usa a API LocalDB, consulte SQL Server Express LocalDB Reference.

Confira também

Cabeçalho e informações de versão de LocalDB do SQL Server Express