LocalDBFormatMessage 函式
適用於:SQL Server
傳回所指定 SQL Server Express LocalDB 錯誤的當地語系化文字描述。
頭檔: msoledbsql.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 參考。