다음을 통해 공유


LocalDBFormatMessage function

Applies to:SQL Server

지정한 SQL Server Express LocalDB 오류에 대해 해당 언어의 텍스트 설명을 반환합니다.

Header file:msoledbsql.h

Syntax

HRESULT LocalDBFormatMessage(
           HRESULT hrLocalDB ,
           DWORD dwFlags ,
           DWORD dwLanguageId ,
           LPWSTR wszMessage ,
           LPDWORD lpcchMessage
);

Arguments

hrLocalDB

[입력] LocalDB 오류 코드입니다.

dwFlags

[입력] 이 함수의 동작을 지정하는 플래그입니다.

Available flags:

LOCALDB_TRUNCATE_ERR_MESSAGE

입력 버퍼가 너무 짧으면 오류 메시지가 버퍼에 맞게 잘립니다.

dwLanguageId

[입력] 원하는 언어(LANGID) 또는 0이며, 이 경우 Win32 FormatMessage 언어 순서가 사용됩니다.

wszMessage

[출력] LocalDB 오류 메시지를 저장할 버퍼입니다.

lpcchMessage

[Input/Output] On input, this option contains the size of the wszMessage buffer in characters. 출력에서 지정된 버퍼 크기가 너무 작은 경우 후행 null을 포함하여 문자에 필요한 버퍼 크기를 포함합니다. 함수가 성공하면 이 옵션에는 후행 null을 제외한 메시지의 문자 수가 포함됩니다.

Returns

S_OK: 함수가 성공했습니다.

Error Description
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 The input buffer wszMessage is too short, and truncation isn't requested.
LOCALDB_ERROR_INTERNAL_ERROR 예기치 않은 오류가 발생했습니다. 자세한 내용은 이벤트 로그를 참조하세요.

Remarks

LocalDB API를 사용하는 코드 샘플은 SQL Server Express LocalDB 참조를 참조하세요.