LocalDBGetInstances function

Applies to:SQL Server

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

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

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

lpdwNumberOfInstances

[Input/Output] On input, this option contains the number of slots for instance names in the pInstanceNames buffer. Nell'output, questa opzione contiene il numero di istanze di LocalDB trovate nella workstation dell'utente.

Returns

S_OK: la funzione ha avuto esito positivo.

Error	Description
LOCALDB_ERROR_NOT_INSTALLED	SQL Server Express LocalDB non è installato nel computer.
LOCALDB_ERROR_INVALID_PARAMETER	Uno o più parametri di input specificati non 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 l'istanza deve essere archiviata è più lunga di MAX_PATH.
LOCALDB_ERROR_CANNOT_ACCESS_INSTANCE_REGISTRY	Non è possibile accedere a un registro di istanze.
LOCALDB_ERROR_INSTANCE_CONFIGURATION_CORRUPT	Configurazione di un'istanza danneggiata.
LOCALDB_ERROR_INTERNAL_ERROR	Errore imprevisto. Per informazioni, vedere il registro eventi.

Remarks

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

Related content

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