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，在此情況下會使用 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 | 一或多個指定的輸入參數無效。 |
| 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 參考。