LocalDBFormatMessage 函數
傳回指定之 SQL Server Express LocalDB 錯誤的當地語系化文字描述。
標頭檔: sqlncli.h
語法
HRESULT LocalDBFormatMessage(
HRESULT hrLocalDB,
DWORD dwFlags,
DWORD dwLanguageId,
LPWSTR wszMessage,
LPDWORD lpcchMessage
);
參數
hrLocalDB
[輸入] LocalDB 錯誤碼。
dwFlags
[輸入] 指定此函數行為的旗標。
可用的旗標:
LOCALDB_TRUNCATE_ERR_MESSAGE
如果輸入緩衝區太短,則會截斷錯誤訊息以符合緩衝區。
dwLanguageId
[輸入] 所需語言 (LANGID) 或 0,在任何情況下都會使用 Win32 FormatMessage 語言順序。
wszMessage
[輸出] 儲存 LocalDB 錯誤訊息的緩衝區。
lpcchMessage
[輸入/輸出]在輸入時,會以字元為單位包含 wszMessage 緩衝區的大小。 輸出時,如果指定的緩衝區大小太小,則會包含所需的緩衝區大小 (以字元為單位),包括尾端的 Null。 如果函數成功,則會在訊息中包含字元數,尾端的 Null 不計。
傳回
S_OK
此函數已成功。
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
輸入緩衝區 wszMessage太短,而且不會要求截斷。
LOCALDB_ERROR_INTERNAL_ERROR
發生意外錯誤。 請參閱事件記錄檔,以取得詳細資料。
備註
如需使用 LocalDB API 的程式碼範例,請參閱SQL Server Express LocalDB 參考。