Funzione LocalDBGetInstances

Vengono restituite tutte le istanze del database locale di SQL Server Express con la versione specificata.

File di intestazione: sqlncli.h

Sintassi

#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
);

Parametri

• pInstanceNames
  [Output] Il risultato restituito da questa funzione è costituito da nomi sia di istanze denominate sia di quelle predefinite del database locale nella workstation dell'utente.

• lpdwNumberOfInstances
  [Input/output] In fase di input, in questo parametro è contenuto il numero di slot per i nomi delle istanze nel buffer pInstanceNames. In fase di output, è invece incluso il numero di istanze del database locale trovate nella workstation dell'utente.

Valori restituiti

• S_OK
  Funzione completata.

• LOCALDB_ERROR_NOT_INSTALLED
  Database locale di SQL Server Express non installato nel computer.

• LOCALDB_ERROR_INVALID_PARAMETER
  Uno o più parametri di input specificati non validi.

• LOCALDB_ERROR_INSUFFICIENT_BUFFER
  Buffer di input troppo corto. Troncamento non necessario.

• LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG
  Percorso di archiviazione richiesto per l'istanza più lungo di MAX_PATH.

• LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY
  Impossibile accedere al Registro di sistema di un'istanza.

• LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
  Configurazione di un'istanza danneggiata.

• LOCALDB_ERROR_INTERNAL_ERROR
  Errore imprevisto. Per informazioni, vedere il registro eventi.

Osservazioni

Per un esempio di codice in cui viene utilizzata l'API LocalDB, vedere Riferimento al database locale di SQL Server Express.

Vedere anche

Concetti

Informazioni sulla versione e intestazione del database locale di SQL Server Express