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

另請參閱

SQL Server Express LocalDB 標頭和版本資訊