LocalDBFormatMessage function

Applies to:SQL Server

Vrátí lokalizovaný textový popis pro zadanou chybu SQL Server Express LocalDB.

Header file:msoledbsql.h

Syntax

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

Arguments

hrLocalDB

[Vstup] Kód chyby LocalDB.

dwFlags

[Vstup] Příznaky určující chování této funkce.

Available flags:

LOCALDB_TRUNCATE_ERR_MESSAGE

Pokud je vstupní vyrovnávací paměť příliš krátká, chybová zpráva se zkrátí tak, aby odpovídala vyrovnávací paměti.

dwLanguageId

[Vstup] Požadovaný jazyk (LANGID) nebo 0, v takovém případě se použije pořadí jazyka Win32 FormatMessage.

wszMessage

[Výstup] Vyrovnávací paměť pro uložení chybové zprávy LocalDB.

lpcchMessage

[Input/Output] On input, this option contains the size of the wszMessage buffer in characters. Pokud je daná velikost vyrovnávací paměti na výstupu příliš malá, obsahuje požadovanou velikost vyrovnávací paměti ve znacích, včetně všech koncových hodnot null. Pokud je funkce úspěšná, obsahuje tato možnost počet znaků ve zprávě s výjimkou koncových hodnot null.

Returns

S_OK: Funkce byla úspěšná.

Error	Description
LOCALDB_ERROR_NOT_INSTALLED	SQL Server Express LocalDB není v počítači nainstalovaný.
LOCALDB_ERROR_INVALID_PARAMETER	Jeden nebo více zadaných vstupních parametrů je neplatný.
LOCALDB_ERROR_UNKNOWN_ERROR_CODE	Požadovaná zpráva neexistuje.
LOCALDB_ERROR_UNKNOWN_LANGUAGE_ID	Zpráva není dostupná v požadovaném jazyce.
LOCALDB_ERROR_INSUFFICIENT_BUFFER	The input buffer wszMessage is too short, and truncation isn't requested.
LOCALDB_ERROR_INTERNAL_ERROR	Došlo k neočekávané chybě. Podrobnosti najdete v protokolu událostí.

Remarks

Ukázku kódu, která používá rozhraní LocalDB API, najdete v referenčních informacích k SQL Serveru Express LocalDB.

Related content

• Informace o hlavičce a verzi SQL Serveru Express LocalDB