Compartilhar via


Função LocalDBGetInstances

Aplica-se: SQL Server

Retorna todas as instâncias de LocalDB do SQL Server Express com a versão especificada.

Arquivo de cabeçalho: msoledbsql.h

Sintaxe

#define MAX_LOCALDB_INSTANCE_NAME_LENGTH 128typedef WCHAR TLocalDBInstanceName[MAX_LOCALDB_INSTANCE_NAME_LENGTH + 1];typedef TLocalDBInstanceName* PTLocalDBInstanceName;  
HRESULT LocalDBGetInstances(  
           PTLocalDBInstanceName pInstanceNames,  
           LPDWORD lpdwNumberOfInstances  
);  

Parâmetros

pInstanceNames
[Saída] Quando essa função retorna, contém os nomes das instâncias LocalDB nomeadas e padrão na estação de trabalho do usuário.

lpdwNumberOfInstances
[Entrada/Saída] Na entrada, contém o número de slots dos nomes de instância no buffer pInstanceNames . Na saída, contém o número de instâncias do LocalDB encontradas na estação de trabalho do usuário.

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_INSUFFICIENT_BUFFER
O buffer de entrada é muito curto e o truncamento não foi solicitado.

LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG
O caminho em que a instância deve estar armazenada não é maior que MAX_PATH.

LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY
Não é possível acessar um registro de instância.

LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
Uma configuração de instância está corrompida.

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