Funzione LocalDBFormatMessage

Viene restituita la descrizione testuale localizzata per l'errore del database locale di SQL Server Express 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 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] In fase di input, nel parametro sono contenute 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
  Parametro wszMessage del buffer di input troppo corto. Troncamento non necessario.

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

Osservazioni

Per un esempio di codice in cui viene utilizzata l'API LocalDB, vedere Riferimento al database locale di SQL Server Express.

Vedere anche

Concetti

Informazioni sulla versione e intestazione del database locale di SQL Server Express