Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Applies to:
SQL Server
Retorna todas as instâncias de LocalDB do SQL Server Express com a versão especificada.
Header file:msoledbsql.h
Syntax
#define MAX_LOCALDB_INSTANCE_NAME_LENGTH 128typedef WCHAR TLocalDBInstanceName [ MAX_LOCALDB_INSTANCE_NAME_LENGTH + 1 ] ;
typedef TLocalDBInstanceName* PTLocalDBInstanceName;
HRESULT LocalDBGetInstances(
PTLocalDBInstanceName pInstanceNames ,
LPDWORD lpdwNumberOfInstances
);
Arguments
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
[Input/Output] On input, this option contains the number of slots for instance names in the pInstanceNames buffer. Na saída, essa opção contém o número de instâncias localdb encontradas na estação de trabalho do usuário.
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_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 | 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.