Função LocalDBGetInstances

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

Arquivo de cabeçalho: sqlncli.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 de 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 para nomes de instância no buffer pInstanceNames . Na saída, contém o número de instâncias 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 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_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 ser armazenada é 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
Ocorreu um erro inesperado. Consulte o log de eventos para obter detalhes.

Observações

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

Consulte Também

Informações de cabeçalho e versão do SQL Server Express LocalDB