Export (0) Print
Expand All

LocalDBFormatMessage Function

Returns the localized textual description for the specified SQL Server Express LocalDB error.

Header file: sqlncli.h

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

hrLocalDB

[Input] The LocalDB error code.

dwFlags

[Input] The flags specifying the behavior of this function.

Available flags:

LOCALDB_TRUNCATE_ERR_MESSAGE

If the input buffer is too short, the error message will be truncated to fit the buffer.

dwLanguageId

[Input] The language desired (LANGID) or 0, in which case the Win32 FormatMessage language order is used.

wszMessage

[Output] The buffer to store the LocalDB error message.

lpcchMessage

[Input/Output] On input contains the size of the wszMessage buffer in characters. On output, if the given buffer size is too small, contains the buffer size required in characters, including any trailing nulls. If the function succeeds, contains the number of characters in the message, excluding any trailing nulls.

S_OK

The function succeeded.

LOCALDB_ERROR_NOT_INSTALLED

SQL Server Express LocalDB is not installed on the computer.

LOCALDB_ERROR_INVALID_PARAMETER

One or more specified input parameters are invalid.

LOCALDB_ERROR_UNKNOWN_ERROR_CODE

The requested message does not exist.

LOCALDB_ERROR_UNKNOWN_LANGUAGE_ID

The message is not available in the requested language.

LOCALDB_ERROR_INSUFFICIENT_BUFFER

The input buffer wszMessage is too short, and truncation is not requested.

LOCALDB_ERROR_INTERNAL_ERROR

An unexpected error occurred. See the event log for details.

For a code sample that uses LocalDB API, see SQL Server Express LocalDB Reference.

Community Additions

ADD
Show:
© 2014 Microsoft