Função LocalDBGetInstances

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

Arquivo de cabeçalho: sqlncli.h

Sintaxe

#define MAX_LOCALDB_INSTANCE_NAME_LENGTH 128
typedef WCHAR TLocalDBInstanceName[MAX_LOCALDB_INSTANCE_NAME_LENGTH + 1];
typedef TLocalDBInstanceName* PTLocalDBInstanceName;

HRESULT LocalDBGetInstances(
           PTLocalDBInstanceName pInstanceNames,
           LPDWORD lpdwNumberOfInstances
);

Parâmetros

• pInstanceNames
  [Saída] Quando esta função for retornada, conterá os nomes das instâncias de 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 de LocalDB localizadas na estação de trabalho do usuário.

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_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 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