LocalDBFormatMessage function

Applies to:SQL Server

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

Header file:msoledbsql.h

Syntax

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

Arguments

hrLocalDB

[Input] Codice di errore del database locale.

dwFlags

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

Available flags:

LOCALDB_TRUNCATE_ERR_MESSAGE

Se il buffer di input è troppo breve, il messaggio di errore viene troncato per adattarsi 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] On input, this option contains the size of the wszMessage buffer in characters. 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 ha esito positivo, questa opzione contiene il numero di caratteri nel messaggio, escludendo eventuali valori Null finali.

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_UNKNOWN_ERROR_CODE	Il messaggio richiesto non esiste.
LOCALDB_ERROR_UNKNOWN_LANGUAGE_ID	Il messaggio non è disponibile nella lingua richiesta.
LOCALDB_ERROR_INSUFFICIENT_BUFFER	The input buffer wszMessage is too short, and truncation isn't requested.
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