Funzione LocalDBFormatMessage

Articolo
07/04/2024

Si applica a: SQL Server

Viene restituita la descrizione testuale localizzata per l'errore del database locale di SQL Server Express specificato.

File di intestazione: msoledbsql.h

Sintassi

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

Parametri

hrLocalDB
[Input] Codice di errore del database locale.

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

Flag disponibili:

LOCALDB_TRUNCATE_ERR_MESSAGE
Se il buffer di input è troppo corto, il messaggio di errore sarà troncato in base al buffer.

dwLanguageId
[Input] Lingua desiderata (LANGID) o 0. In tal caso viene utilizzato l'ordine della lingua FormatMessage di Win32.

wszMessage
[Output] Buffer per archiviare il messaggio di errore del database locale.

lpcchMessage
[Input/Output] L'input contiene le dimensioni del buffer wszMessage in caratteri. In fase di output, se le dimensioni del buffer specificate sono troppo piccole, nel parametro sono contenute le dimensioni del buffer richieste in caratteri, inclusi gli spazi vuoti finali. Se la funzione viene completata, in essa è contenuto il numero di caratteri nel messaggio, esclusi gli spazi vuoti finali.

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_UNKNOWN_ERROR_CODE
Messaggio richiesto inesistente.

LOCALDB_ERROR_UNKNOWN_LANGUAGE_ID
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, 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