Freigeben über


LocalDBFormatMessage function

Applies to:SQL Server

Gibt die lokalisierte Textbeschreibung für den angegebenen SQL Server Express LocalDB-Fehler zurück.

Header file:msoledbsql.h

Syntax

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

Arguments

hrLocalDB

[Eingabe] Der LocalDB-Fehlercode.

dwFlags

[Eingabe] Die Flags, die das Verhalten dieser Funktion angeben.

Available flags:

LOCALDB_TRUNCATE_ERR_MESSAGE

Wenn der Eingabepuffer zu kurz ist, wird die Fehlermeldung abgeschnitten, um den Puffer anzupassen.

dwLanguageId

[Eingabe] Die gewünschte Sprache (LANGID) oder 0, falls die Win32 FormatMessage-Sprachreihenfolge verwendet wird.

wszMessage

[Ausgabe] Der Puffer zum Speichern der LocalDB-Fehlermeldung.

lpcchMessage

[Input/Output] On input, this option contains the size of the wszMessage buffer in characters. Wenn der angegebene Puffer zu klein ist, enthält dieses Objekt bei Ausgabe die erforderliche Puffergröße in Zeichen, einschließlich sämtlicher nachfolgender Nullen. Wenn die Funktion erfolgreich ist, enthält diese Option die Anzahl der Zeichen in der Nachricht, mit Ausnahme von nachfolgenden Nullen.

Returns

S_OK: Die Funktion war erfolgreich.

Error Description
LOCALDB_ERROR_NOT_INSTALLED SQL Server Express LocalDB ist nicht auf dem Computer installiert.
LOCALDB_ERROR_INVALID_PARAMETER Mindestens ein angegebener Eingabeparameter ist ungültig.
LOCALDB_ERROR_UNKNOWN_ERROR_CODE Die angeforderte Nachricht ist nicht vorhanden.
LOCALDB_ERROR_UNKNOWN_LANGUAGE_ID Die Nachricht ist in der angeforderten Sprache nicht verfügbar.
LOCALDB_ERROR_INSUFFICIENT_BUFFER The input buffer wszMessage is too short, and truncation isn't requested.
LOCALDB_ERROR_INTERNAL_ERROR Ein unerwarteter Fehler ist aufgetreten. Weitere Informationen finden Sie im Ereignisprotokoll.

Remarks

Ein Codebeispiel, das die LocalDB-API verwendet, finden Sie unter SQL Server Express LocalDB-Referenz.