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 參考

另請參閱

SQL Server Express LocalDB 標頭和版本資訊