Delen via


LocalDBFormatMessage function

Applies to:SQL Server

Retourneert de gelokaliseerde tekstuele beschrijving voor de opgegeven SQL Server Express LocalDB-fout.

Header file:msoledbsql.h

Syntax

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

Arguments

hrLocalDB

[Invoer] De LocalDB-foutcode.

dwFlags

[Invoer] De vlaggen die het gedrag van deze functie opgeven.

Available flags:

LOCALDB_TRUNCATE_ERR_MESSAGE

Als de invoerbuffer te kort is, wordt het foutbericht afgekapt zodat deze past bij de buffer.

dwLanguageId

[Invoer] De gewenste taal (LANGID) of 0, in welk geval de Win32 FormatMessage-taalvolgorde wordt gebruikt.

wszMessage

[Uitvoer] De buffer voor het opslaan van het LocalDB-foutbericht.

lpcchMessage

[Input/Output] On input, this option contains the size of the wszMessage buffer in characters. Als de opgegeven buffergrootte te klein is, bevat de buffergrootte die is vereist in tekens, inclusief eventuele volg null's. Als de functie slaagt, bevat deze optie het aantal tekens in het bericht, met uitzondering van eventuele volg null-waarden.

Returns

S_OK: De functie is geslaagd.

Error Description
LOCALDB_ERROR_NOT_INSTALLED SQL Server Express LocalDB is niet geïnstalleerd op de computer.
LOCALDB_ERROR_INVALID_PARAMETER Een of meer opgegeven invoerparameters zijn ongeldig.
LOCALDB_ERROR_UNKNOWN_ERROR_CODE Het gevraagde bericht bestaat niet.
LOCALDB_ERROR_UNKNOWN_LANGUAGE_ID Het bericht is niet beschikbaar in de aangevraagde taal.
LOCALDB_ERROR_INSUFFICIENT_BUFFER The input buffer wszMessage is too short, and truncation isn't requested.
LOCALDB_ERROR_INTERNAL_ERROR Er is een onverwachte fout opgetreden. Zie het gebeurtenislogboek voor meer informatie.

Remarks

Zie sql Server Express LocalDB-referentie voor een codevoorbeeld dat gebruikmaakt van de LocalDB-API van LocalDB.