次の方法で共有


LocalDBFormatMessage function

Applies to:SQL Server

指定した SQL Server Express LocalDB エラーについてのローカライズされた説明テキストを返します。

Header file:msoledbsql.h

Syntax

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

Arguments

hrLocalDB

[入力] LocalDB のエラー コード。

dwFlags

[入力] この関数の動作を指定するフラグ。

Available flags:

LOCALDB_TRUNCATE_ERR_MESSAGE

入力バッファーが短すぎる場合、エラー メッセージはバッファーに収まるように切り捨てられます。

dwLanguageId

[入力] 目的の言語 (LANGID) または 0。0 の場合、Win32 FormatMessage 言語順序が使用されます。

wszMessage

[出力] LocalDB エラー メッセージを格納するバッファー。

lpcchMessage

[Input/Output] On input, this option contains the size of the wszMessage buffer in characters. 出力側では、所定のバッファー サイズが小さすぎる場合、末尾の NULL も含め、必要なバッファー サイズ (単位は文字数) を格納します。 関数が成功した場合、このオプションには、末尾の null を除く、メッセージ内の文字数が含まれます。

Returns

S_OK: 関数は成功しました。

Error Description
LOCALDB_ERROR_NOT_INSTALLED SQL Server Express LocalDB がコンピューターにインストールされていません。
LOCALDB_ERROR_INVALID_PARAMETER 指定した 1 つまたは複数の入力パラメーターが無効です。
LOCALDB_ERROR_UNKNOWN_ERROR_CODE 要求されたメッセージが存在しません。
LOCALDB_ERROR_UNKNOWN_LANGUAGE_ID メッセージは、要求された言語では使用できません。
LOCALDB_ERROR_INSUFFICIENT_BUFFER The input buffer wszMessage is too short, and truncation isn't requested.
LOCALDB_ERROR_INTERNAL_ERROR 予期しないエラーが発生しました。 詳細をイベント ログで確認してください。

Remarks

LocalDB API を使用するコード サンプルについては、 SQL Server Express LocalDB リファレンスを参照してください。