다음을 통해 공유


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 Reference를 참조하십시오.

참고 항목

SQL Server Express LocalDB 헤더 및 버전 정보