Função LocalDBShareInstance

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: sqlncli.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.

Retorna

• 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 Referência de LocalDB do SQL Server Express.

Consulte também

Conceitos

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