Bagikan melalui


LocalDBFormatMessage function

Applies to:SQL Server

Mengembalikan deskripsi tekstual yang dilokalkan untuk kesalahan SQL Server Express LocalDB yang ditentukan.

Header file:msoledbsql.h

Syntax

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

Arguments

hrLocalDB

[Input] Kode kesalahan LocalDB.

dwFlags

[Input] Bendera yang menentukan perilaku fungsi ini.

Available flags:

LOCALDB_TRUNCATE_ERR_MESSAGE

Jika buffer input terlalu pendek, pesan kesalahan dipotong agar pas dengan buffer.

dwLanguageId

[Input] Bahasa yang diinginkan (LANGID) atau 0, dalam hal ini urutan bahasa Win32 FormatMessage digunakan.

wszMessage

[Output] Buffer untuk menyimpan pesan kesalahan LocalDB.

lpcchMessage

[Input/Output] On input, this option contains the size of the wszMessage buffer in characters. Pada output, jika ukuran buffer yang diberikan terlalu kecil, berisi ukuran buffer yang diperlukan dalam karakter, termasuk null berikutnya. Jika fungsi berhasil, opsi ini berisi jumlah karakter dalam pesan, tidak termasuk null berikutnya.

Returns

S_OK: Fungsi berhasil.

Error Description
LOCALDB_ERROR_NOT_INSTALLED SQL Server Express LocalDB tidak diinstal di komputer.
LOCALDB_ERROR_INVALID_PARAMETER Satu atau beberapa parameter input yang ditentukan tidak valid.
LOCALDB_ERROR_UNKNOWN_ERROR_CODE Pesan yang diminta tidak ada.
LOCALDB_ERROR_UNKNOWN_LANGUAGE_ID Pesan tidak tersedia dalam bahasa yang diminta.
LOCALDB_ERROR_INSUFFICIENT_BUFFER The input buffer wszMessage is too short, and truncation isn't requested.
LOCALDB_ERROR_INTERNAL_ERROR Terjadi kesalahan tidak terduga. Lihat log peristiwa untuk detailnya.

Remarks

Untuk sampel kode yang menggunakan API LocalDB, lihat referensi SQL Server Express LocalDB.