Funzione LocalDBFormatMessage

Restituisce la descrizione testuale localizzata per l'errore di SQL Server Express LocalDB specificato.

File di intestazione: sqlncli.h

Sintassi

HRESULT LocalDBFormatMessage(  
           HRESULT hrLocalDB,  
           DWORD dwFlags,   
           DWORD dwLanguageId,   
           LPWSTR wszMessage,   
           LPDWORD lpcchMessage   
);  

Parametri

hrLocalDB
[Input] Codice di errore di LocalDB.

dwFlags
[Input] Flag che specificano il comportamento di questa funzione.

Flag disponibili:

LOCALDB_TRUNCATE_ERR_MESSAGE
Se il buffer di input è troppo breve, il messaggio di errore verrà troncato per adattarsi al buffer.

dwLanguageId
[Input] Lingua desiderata (LANGID) o 0, nel qual caso viene usato l'ordine di lingua FormatMessage Win32.

wszMessage
[Output] Buffer in cui archiviare il messaggio di errore localDB.

lpcchMessage
[Input/Output] L'input contiene le dimensioni del buffer wszMessage in caratteri. In caso di output, se la dimensione del buffer specificata è troppo piccola, contiene le dimensioni del buffer necessarie in caratteri, inclusi eventuali valori Null finali. Se la funzione ha esito positivo, contiene il numero di caratteri nel messaggio, esclusi eventuali valori Null finali.

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_UNKNOWN_ERROR_CODE
Il messaggio richiesto non esiste.

LOCALDB_ERROR_UNKNOWN_LANGUAGE_ID
Il messaggio non è disponibile nella lingua richiesta.

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

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