Funzione LocalDBGetInstances

Restituisce tutte le istanze di SQL Server Express LocalDB con la versione specificata.

File di intestazione: sqlncli.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.

Restituzioni

S_OK
Funzione completata.

LOCALDB_ERROR_NOT_INSTALLED
SQL Server Express LocalDB non è installato nel computer.

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

LOCALDB_ERROR_INSUFFICIENT_BUFFER
Il buffer di input è troppo breve e il troncamento non è stato richiesto.

LOCALDB_ERROR_INSTANCE_FOLDER_PATH_TOO_LONG
Il percorso in cui deve essere archiviata l'istanza è più lungo di MAX_PATH.

LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY
Non è possibile accedere a un registro di istanze.

LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT
Una configurazione dell'istanza è danneggiata.

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

Osservazioni:

Per un esempio di codice che usa l'API LocalDB, vedere Informazioni di riferimento su SQL Server Express LocalDB.

Vedere anche

Informazioni sull'intestazione e sulla versione di SQL Server Express LocalDB