Aracılığıyla paylaş


LocalDBFormatMessage function

Applies to:SQL Server

Belirtilen SQL Server Express LocalDB hatası için yerelleştirilmiş metinsel açıklamayı döndürür.

Header file:msoledbsql.h

Syntax

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

Arguments

hrLocalDB

[Giriş] LocalDB hata kodu.

dwFlags

[Giriş] Bu işlevin davranışını belirten bayraklar.

Available flags:

LOCALDB_TRUNCATE_ERR_MESSAGE

Giriş arabelleği çok kısaysa, hata iletisi arabelleğe sığacak şekilde kesilir.

dwLanguageId

[Giriş] İstenen dil (LANGID) veya 0, bu durumda Win32 FormatMessage dil sırası kullanılır.

wszMessage

[Çıkış] LocalDB hata iletisini depolamak için arabellek.

lpcchMessage

[Input/Output] On input, this option contains the size of the wszMessage buffer in characters. Çıktıda, verilen arabellek boyutu çok küçükse, sonundaki null değerler de dahil olmak üzere karakter cinsinden gereken arabellek boyutunu içerir. İşlev başarılı olursa, bu seçenek iletideki karakterlerin sayısını içerir ve sondaki null değerleri hariç tutarak.

Returns

S_OK: İşlev başarılı oldu.

Error Description
LOCALDB_ERROR_NOT_INSTALLED SQL Server Express LocalDB bilgisayarda yüklü değil.
LOCALDB_ERROR_INVALID_PARAMETER Belirtilen bir veya daha fazla giriş parametresi geçersiz.
LOCALDB_ERROR_UNKNOWN_ERROR_CODE İstenen ileti yok.
LOCALDB_ERROR_UNKNOWN_LANGUAGE_ID İleti istenen dilde kullanılamıyor.
LOCALDB_ERROR_INSUFFICIENT_BUFFER The input buffer wszMessage is too short, and truncation isn't requested.
LOCALDB_ERROR_INTERNAL_ERROR Beklenmeyen bir hata oluştu. Ayrıntılar için olay günlüğüne bakın.

Remarks

LocalDB API'sini kullanan bir kod örneği için bkz. SQL Server Express LocalDB başvurusu.