Partilhar via

LocalDBGetInstances function

Applies to:SQL Server

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

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

[Realização] Quando essa função retorna, contém os nomes das instâncias de 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 onde a instância deve ser armazenada é maior que MAX_PATH.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY Um registro de instância não pode ser acessado.
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.

Remarks

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

Related content

  • Last updated on