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 標頭和版本資訊