CDBErrorInfo 클래스
OLE DB IErrorRecords 인터페이스를 사용하여 OLE DB 오류 처리를 지원합니다 .
구문
class CDBErrorInfo
요구 사항
헤더: atldbcli.h
멤버
메서드
| 속성 | 설명 |
|---|---|
| GetAllErrorInfo | 오류 레코드에 포함된 모든 오류 정보를 반환합니다. |
| GetBasicErrorInfo | IErrorRecords::GetBasicErrorInfo를 호출하여 지정된 오류에 대한 기본 정보를 반환합니다. |
| GetCustomErrorObject | IErrorRecords::GetCustomErrorObject를 호출하여 사용자 지정 오류 개체의 인터페이스에 대한 포인터를 반환합니다. |
| GetErrorInfo | IErrorRecords::GetErrorInfo를 호출하여 지정된 레코드에 대한 IErrorInfo 인터페이스 포인터를 반환합니다. |
| GetErrorParameters | IErrorRecords::GetErrorParameters를 호출 하여 오류 매개 변수를 반환합니다 . |
| GetErrorRecords | 지정된 개체에 대한 오류 레코드를 가져옵니다. |
설명
이 인터페이스는 사용자에게 하나 이상의 오류 레코드를 반환합니다. CDBErrorInfo::GetErrorRecords를 먼저 호출하여 오류 레코드 수를 가져옵니다. 그런 다음 CDBErrorInfo::GetAllErrorInfo와 같은 액세스 함수 중 하나를 호출하여 각 레코드에 대한 오류 정보를 검색합니다.
CDBErrorInfo::GetAllErrorInfo
오류 레코드에 포함된 모든 유형의 오류 정보를 반환합니다.
구문
HRESULT GetAllErrorInfo(ULONG ulRecordNum,
LCID lcid, BSTR* pbstrDescription,
BSTR* pbstrSource = NULL,
GUID* pguid = NULL,
DWORD* pdwHelpContext = NULL,
BSTR* pbstrHelpFile = NULL) const throw();
매개 변수
ulRecordNum
[in] 오류 정보를 반환할 레코드의 0부터 시작하는 번호입니다.
lcid
[in] 반환할 오류 정보에 대한 로캘 ID입니다.
pbstrDescription
[out] 오류에 대한 텍스트 설명에 대한 포인터이거나 로캘이 지원되지 않는 경우 NULL입니다. 설명 부분을 참조하세요.
pbstrSource
[out] 오류를 생성한 구성 요소의 이름을 포함하는 문자열에 대한 포인터입니다.
pguid
[out] 오류를 정의한 인터페이스의 GUID에 대한 포인터입니다.
pdwHelpContext
[out] 오류에 대한 도움말 컨텍스트 ID에 대한 포인터입니다.
pbstrHelpFile
[out] 오류를 설명하는 도움말 파일의 경로를 포함하는 문자열에 대한 포인터입니다.
Return Value
성공하면 S_OK. 다른 반환 값은 OLE DB 프로그래머 참조에서 IErrorRecords::GetErrorInfo를 참조 하세요.
설명
pbstrDescription의 출력 값은 로캘이 지원되지 않거나 다음 조건이 모두 true인 경우 값을 NULL로 설정하는 호출IErrorInfo::GetDescription을 통해 내부적으로 가져옵니다.
lcid 값은 미국 영어가 아니고
lcid 값이 GetUserDefaultLCID에서 반환된 값과 같지 않습니다.
CDBErrorInfo::GetBasicErrorInfo
IErrorRecords::GetBasicErrorInfo를 호출하여 반환 코드 및 공급자별 오류 번호와 같은 오류에 대한 기본 정보를 반환합니다.
구문
HRESULT GetBasicErrorInfo(ULONG ulRecordNum,
ERRORINFO* pErrorInfo) const throw();
매개 변수
OLE DB 프로그래머 참조에서 IErrorRecords::GetBasicErrorInfo를 참조하세요.
Return Value
표준 HRESULT입니다.
CDBErrorInfo::GetCustomErrorObject
IErrorRecords::GetCustomErrorObject를 호출하여 사용자 지정 오류 개체의 인터페이스에 대한 포인터를 반환합니다.
구문
HRESULT GetCustomErrorObject(ULONG ulRecordNum,
REFIID riid,IUnknown** ppObject) const throw();
매개 변수
OLE DB 프로그래머 참조에서 IErrorRecords::GetCustomErrorObject를 참조하세요.
Return Value
표준 HRESULT입니다.
CDBErrorInfo::GetErrorInfo
IErrorRecords::GetErrorInfo를 호출하여 지정된 레코드에 대한 IErrorInfo 인터페이스 포인터를 반환 합니다.
구문
HRESULT GetErrorInfo(ULONG ulRecordNum,
LCID lcid,IErrorInfo** ppErrorInfo) const throw();
매개 변수
OLE DB 프로그래머 참조에서 IErrorRecords::GetErrorInfo를 참조하세요.
Return Value
표준 HRESULT입니다.
CDBErrorInfo::GetErrorParameters
IErrorRecords::GetErrorParameters를 호출 하여 오류 매개 변수를 반환합니다 .
구문
HRESULT GetErrorParameters(ULONG ulRecordNum,
DISPPARAMS* pdispparams) const throw();
매개 변수
OLE DB 프로그래머 참조에서 IErrorRecords::GetErrorParameters를 참조하세요.
Return Value
표준 HRESULT입니다.
CDBErrorInfo::GetErrorRecords
지정된 개체에 대한 오류 레코드를 가져옵니다.
구문
HRESULT GetErrorRecords(IUnknown* pUnk,
const IID& iid,
ULONG* pcRecords) throw();
HRESULT GetErrorRecords(ULONG* pcRecords) throw();
매개 변수
pUnk
[in] 오류 레코드를 가져올 개체에 대한 인터페이스입니다.
iid
[in] 오류와 연결된 인터페이스의 IID입니다.
pcRecords
[out] 오류 레코드의 (1부터 시작하는) 수에 대한 포인터입니다.
Return Value
표준 HRESULT입니다.
설명
오류 정보를 가져올 인터페이스를 확인하려면 함수의 첫 번째 형식을 사용합니다. 그렇지 않으면 두 번째 양식을 사용합니다.