Funzione LocalDBGetInstances

Articolo
07/04/2024

Si applica a: SQL Server

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

File di intestazione: msoledbsql.h

Sintassi

#define MAX_LOCALDB_INSTANCE_NAME_LENGTH 128typedef WCHAR TLocalDBInstanceName[MAX_LOCALDB_INSTANCE_NAME_LENGTH + 1];typedef TLocalDBInstanceName* PTLocalDBInstanceName;  
HRESULT LocalDBGetInstances(  
           PTLocalDBInstanceName pInstanceNames,  
           LPDWORD lpdwNumberOfInstances  
);

Parametri

pInstanceNames
[Output] Quando questa funzione viene restituita, contiene i nomi delle istanze localDB denominate e predefinite nella workstation dell'utente.

lpdwNumberOfInstances
[Input/Output] In caso di input, contiene il numero di slot per i nomi di istanza nel buffer pInstanceNames . Nell'output contiene il numero di istanze di LocalDB 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 che usa l'API LocalDB, vedere Informazioni di riferimento su SQL Server Express LocalDB.

Vedi anche

Informazioni sulla versione e intestazione di SQL Server Express LocalDB

Condividi tramite